What problem does it solve? Creating a new Agent Skill from scratch often produces inconsistent folders with missing frontmatter, placeholder content, and no validation, making skills hard to discover and unreliable to ship. ## Core Features & Use Cases - Convention-based scaffolding: Generates a complete skill folder (SKILL.md with frontmatter, quality bar, staged workflow, production checklist) using a category-aware pattern library or by cloning an existing sibling skill via --from-template. - Automated audit harness: audit-scaffold.mjs checks frontmatter, rail enforceability, script completeness, template depth, examples, and docs wiring, then a fresh scaffold-auditor subagent signs PASS or FIX NEEDED. - Docs wiring automation: auto-docs.mjs inserts the new skill into README, USAGE, prompt-examples, and install files while keeping skill counts consistent. - Use Case: A maintainer wants to add a podcast-to-shorts skill to the repo; they run scaffold-skill.mjs with a name and description, fill the placeholders, wire the docs, and pass the audit gate before shipping. ## Quick Start Ask the agent to scaffold a new skill named podcast-to-shorts with a one-line description, two scripts, and one worked example, then run the audit harness.
