skill-forgelisted

# Skill Forge ## What this does Orchestrates this repo's own tooling to add a correct, well-formed skill: it scaffolds the folder, fills the frontmatter against the three-axis taxonomy, validates it, regenerates the README index, and registers it in the marketplace manifest. It is the meta skill that lets the marketplace extend itself. ## When to use it - Creating a brand-new skill in this repository. - A skill fails `validate_frontmatter.py` and you need to bring it to spec. - Refreshing the README index / marketplace manifest after adding a skill. ## How to use it Run all commands from the **repo root**. The heavy lifting lives in the repo's root `scripts/` — this skill drives them; it does not reimplement them. 1. **Scaffold** the folder with the root script (it pre-fills + validates the name and taxonomy values you pass): ``` python scripts/new_skill.py <name> \ --category "Data & Analysis" --lifecycle Plan --domain Finance \ --description "Does X. Use when Y." ``` `<name>` must be kebab-case, equal the folder name, and not contain `claude`/`anthropic`. 2. **Write the body** of `skills/<name>/SKILL.md` following `template/SKILL.md` and the three-axis taxonomy in `docs/taxonomy.md`. Keep the body order: Title → What this does → When to use it → How to use it (numbered) → Inputs → Output → Notes & constraints. Keep it tight (< ~250 lines); push detail into `references/`, deterministic steps into `scripts/`, templates into `a