|
| 1 | +# skill-creator |
| 2 | + |
| 3 | +Create, evaluate, and iterate on high-quality agent skills with structured guidance, quality scoring, and best-practice enforcement. |
| 4 | + |
| 5 | +## What it does |
| 6 | + |
| 7 | +- **Create** new skills from scratch with step-by-step guidance through architecture planning, SKILL.md writing, reference file creation, and quality validation |
| 8 | +- **Evaluate** existing skills against a 10-dimension quality rubric (trigger quality, defaults, step architecture, reference strategy, output template, etc.) with benchmark comparisons |
| 9 | +- **Improve** skills by scoring them, proposing ranked improvements, and applying targeted patches |
| 10 | + |
| 11 | +The skill encodes patterns extracted from analyzing 20+ production finance skills and 120+ hermes-agent skills, distilling what separates top-tier skills (sepa-strategy, options-payoff) from mediocre ones. |
| 12 | + |
| 13 | +**Core rule:** Skills must always detect available tools at runtime and adapt with decision trees and fallback paths — never hardcode a single method. |
| 14 | + |
| 15 | +## Triggers |
| 16 | + |
| 17 | +- "create a skill", "make a new skill", "build a skill for", "write a skill that" |
| 18 | +- "improve this skill", "optimize this skill", "this skill isn't working well" |
| 19 | +- "evaluate this skill", "score this skill", "how good is this skill" |
| 20 | +- "run evals on", "benchmark this skill", "test this skill's quality" |
| 21 | +- "turn this into a skill", "I keep doing X manually", "can you remember how to do X" |
| 22 | + |
| 23 | +## Platform |
| 24 | + |
| 25 | +Works on **Claude Code** and other CLI-based agents. Also works on **Claude.ai** for evaluation and planning (skill file creation requires CLI). |
| 26 | + |
| 27 | +## Setup |
| 28 | + |
| 29 | +```bash |
| 30 | +# As a plugin (recommended) |
| 31 | +npx plugins add himself65/finance-skills --plugin finance-skill-creator |
| 32 | + |
| 33 | +# Or install just this skill |
| 34 | +npx skills add himself65/finance-skills --skill skill-creator |
| 35 | +``` |
| 36 | + |
| 37 | +See the [main README](../../../../README.md) for more installation options. |
| 38 | + |
| 39 | +## Reference files |
| 40 | + |
| 41 | +- `references/dynamic-calling.md` -- **Core**: Detection flows, decision trees, method fallbacks, runtime awareness, 9 patterns from production skills |
| 42 | +- `references/architecture-patterns.md` -- Linear, Router, Methodology, Widget, and API Wrapper patterns with examples and anti-patterns |
| 43 | +- `references/frontmatter-guide.md` -- Complete YAML frontmatter field reference (name, description, platform, env vars, config, credentials) |
| 44 | +- `references/quality-rubric.md` -- 10-dimension scoring rubric with 1-10 scales, benchmark scores, and score interpretation |
| 45 | +- `references/skill-examples.md` -- Annotated excerpts from top skills showing why specific patterns work |
| 46 | +- `references/writing-guide.md` -- How to write each SKILL.md section, detection flows, defaults tables, and output templates |
0 commit comments