Skill Creator

If you're building skills for Claude, this is your reference guide. It walks through the full anatomy of a skill file, from YAML frontmatter to bundled scripts and assets, with clear guidance on when to use each. The progressive disclosure pattern is smart: keep SKILL.md under 500 lines, split domain-specific content into reference files, and remember that conciseness matters because context windows are shared across everything. The degrees of freedom framework is especially useful for deciding whether to give text instructions, pseudocode, or locked-down scripts. Honestly just wish this existed as the official docs instead of being packaged as a skill.

skills.sh installs: 2.6K
GitHub stars: 382.8K
last updated: Jul 14, 2026

View on GitHub

Install

$ npx -y skills add steipete/clawdis --skill skill-creator --agent claude-code

Installs into .claude/skills of the current project.

Files

Skill Creator

Workflow

Establish the contract.
- Read the existing skill and its resources, or collect concrete requests for a new skill.
- Separate actual workflow branches from synonyms for the same branch.
- Done when: every branch has a concrete trigger, expected outcome, and persistence target.
Choose invocation.
- Model-discoverable: write a model-facing description; omit disable-model-invocation.
- Manual-only: set disable-model-invocation: true; write a human-facing summary.
- Direct tool command: add command-dispatch: tool, command-tool, and command-arg-mode only when the command bypasses the model.
- Done when: frontmatter matches how the skill will actually be reached.