Skill creator scaffolding plugin¶
- Date: 2026-04-21
- Status: Accepted
- Tags:
tooling
Context¶
Building custom Claude Code skills requires specific file structure and metadata conventions (SKILL.md, frontmatter, trigger patterns). Getting the structure wrong causes skills to silently fail to load or behave unexpectedly. There is no built-in scaffolding tool, so each new skill is created manually by copying and adapting an existing one.
Decision¶
Install the skill-creator plugin on the work laptop. It generates correct skill scaffolding with proper SKILL.md structure, frontmatter, and metadata fields, reducing boilerplate and preventing structural mistakes.
Alternatives Considered¶
| Option | Why Rejected |
|---|---|
| Manual copy-paste from existing skills | Error-prone; easy to miss required fields |
| Shell script for scaffolding | Works but one more custom script to maintain |
| superpowers:writing-skills only | Provides guidance but does not generate file scaffolding |
Consequences¶
Positive:
- Correct skill structure every time, no silent failures from missing metadata
- Faster skill creation workflow
Negative / Trade-offs:
- Plugin conventions may drift from Claude Code skill format over time
- Another plugin to keep updated
Ongoing obligations:
- ✅ Validated 2026-04-21 —
skill-creator:skill-creatorskill confirmed active on work laptop - Cross-check generated scaffolding against current Claude Code skill format periodically