skill-creator

Create, evaluate, and iteratively improve SKILL.md descriptions with Python scripts.

Updated Aug 15, 2025
One-click install
npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill skill-creator-gesmith0606
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/gesmith0606/nfl_data_engineering/tree/main/web/frontend/.agents/skills/skill-creator
Command: npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill skill-creator-gesmith0606

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Helps teams and developers create, test, and iteratively improve Claude-style Skills by providing a repeatable workflow for drafting SKILL.md, generating test prompts, running parallel evaluations, grading outputs, and optimizing skill descriptions to improve triggering accuracy.

Core Features & Use Cases

  • Skill authoring: Guided prompts and templates to draft SKILL.md with clear metadata and instructions.
  • Eval orchestration: Tools to generate eval sets, run trigger tests in parallel, capture timing/tokens, and produce evaluation workspaces.
  • Grading & benchmarking: Grader, blind comparator, and analyzer agents plus aggregation scripts to produce benchmark.json and human-readable reports.
  • Description optimization: Automated loop to propose and test improved SKILL.md descriptions to increase correct triggering and reduce false positives.
  • Use Case: A developer building a new skill can draft the SKILL.md, run 3 realistic test prompts, compare with baseline runs, and iterate until the description reliably triggers for intended queries.

Quick Start

Ask the assistant to draft a SKILL.md for your task, create 2-3 test prompts, run the eval loop, and report which assertions failed and suggested improvements.

Frequently Asked Questions about skill-creator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I evaluate and benchmark AI skills to improve triggering accuracy?

Skill evaluation and benchmarking involves generating test prompts, running parallel baseline comparisons, grading outputs, and aggregating results to iteratively improve skill descriptions. This Skill provides automated workflows to execute this full evaluation loop.

What's the best way to create test prompts for evaluating Claude-style skills?

Creating test prompts for skill evaluation requires generating realistic queries, running trigger tests in parallel, and capturing timing and token data. This Skill includes scripted tools to generate eval sets and orchestrate parallel trigger evaluations automatically.

How do I optimize skill descriptions to reduce false positive triggers?

Optimizing skill descriptions to reduce false positives requires an automated loop that proposes description variants, tests them against baseline runs, and grades outputs. This Skill runs description optimization iterations to increase correct triggering rates.

Can I run parallel skill evaluations and compare outputs without a manual setup?

Running parallel skill evaluations and comparing outputs is supported through included Python scripts and a local review server. The Skill captures timing, tokens, and produces benchmark.json files along with human-readable reports automatically.

Do I need Python and pyyaml installed to run skill benchmarking scripts?

Python and the pyyaml dependency are required to run the skill benchmarking, test generation, and description optimization scripts. The Skill relies on these Python scripts and local server components to execute automated evaluation workflows.

What is a SKILL.md file and when do I need to draft one for AI automation?

A SKILL.md file defines metadata and instructions for Claude-style AI skills, needed when developers or product teams build automated workflows. This Skill provides guided prompts and templates to author clear SKILL.md descriptions for intended queries.