skill-builder

## Guidance Location The authoritative skill-authoring guidance ships in this plugin. Read the specific document a decision needs, when that decision is on the table — never read them all up front, because that defeats progressive disclosure and burns context on guidance the current skill does not touch. - Plugin-building guidance root: `${CLAUDE_PLUGIN_ROOT}/skills/guidance/references/` - Skill-specific guidance: `${CLAUDE_PLUGIN_ROOT}/skills/guidance/references/skill-building-guidance/` Map from decision to governing document (read just-in-time): | Decision on the table | Read | |---|---| | Skill vs. agent vs. hook | `plugin-entity-taxonomy.md` | | Use cases, trigger phrases, test cases | `skill-building-guidance/use-case-planning.md` | | Directory name, file name, dependency prefix | `skill-building-guidance/naming-conventions.md` | | The `description` field (four components, boundaries) | `skill-building-guidance/skill-description-frontmatter.md`, `skill-building-guidance/skill-description-length.md` | | Which frontmatter fields to set | `skill-building-guidance/skill-frontmatter-fields.md` | | Where content lives (body vs. references vs. scripts vs. assets) | `skill-building-guidance/progressive-disclosure.md`, `skill-building-guidance/skill-reference-files.md` | | Step structure and workflow shape | `skill-building-guidance/workflow-patterns.md`, `skill-building-guidance/writing-effective-instructions.md` | | `allowed-tools`, Bash permission granularity | `skill-bui...