Skip to content

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-creator skill confirmed active on work laptop
  • Cross-check generated scaffolding against current Claude Code skill format periodically