skill-creator · openclaw — Claude skill: build and validate SKILL.md files
A skill for writing, repairing and reviewing other skills. It splits behaviour into branches, sets the frontmatter and sorts resources into folders. Useful once your skill folder gets crowded.
npx skills add openclaw/openclaw --skill skill-creator -a claude-codeWhat skill-creator does
skill-creator walks you through five steps. First you pin down the contract: every branch needs a trigger, an expected outcome and somewhere to persist. Then you pick how the skill gets invoked — model-discoverable through a written description, manual-only with disable-model-invocation: true, or a direct tool command using command-dispatch: tool.
Next comes structure. The shared ordered procedure lives in SKILL.md, and each step ends with a completion criterion you can actually check. Branch-only detail goes to references/, repeatable helpers to scripts/, output files to assets/, optional UI metadata to agents/. Routing conditions stay in description; the body opens with execution.
Validation closes the loop: python {baseDir}/scripts/quick_validate.py plus a focused test run for every helper you touched. Required frontmatter is name and description; add the optional fields only when they change runtime behaviour or discovery. Worth installing if you hand-write skills and keep chasing broken resource pointers. For a single throwaway skill, skip it.
What it helps with
- turn scattered process notes into a working SKILL.md
- fix a skill the model no longer discovers
- move branch detail into references and scripts
- check frontmatter and resource pointers before committing
- restructure someone else's skill to match your folder layout
Example prompts for the agent
- Create a skill that builds release notes from git log
- Review my SKILL.md: frontmatter, resource pointers, step completion criteria
- Split this skill into branches and move the detail into references/
How to install skill-creator
1Skills CLI (Vercel)
npx skills add openclaw/openclaw --skill skill-creator -a claude-code2Manually: put the files in place
~/.claude/skills/skill-creator/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/skill-creator/
1Skills CLI (Vercel)
npx skills add openclaw/openclaw --skill skill-creator -a codex2Manually: put the files in place
.agents/skills/skill-creator/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add openclaw/openclaw --skill skill-creator -a cursor2Manually: put the files in place
.cursor/skills/skill-creator/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install openclaw/openclaw skill-creator2Manually: put the files in place
.github/skills/skill-creator/SKILL.md1Skills CLI (Vercel)
npx skills add openclaw/openclaw --skill skill-creator -a gemini-cli2Platform CLI
gemini skills install https://github.com/openclaw/openclaw --path skills/skill-creatorManually: put the files in place
.devin/skills/skill-creator/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add openclaw/openclaw --skill skill-creator -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set45
The whole set →Other versions of skill-creator
Similar
Questions about skill-creator
How do I install skill-creator in Claude?
Run npx skills add openclaw/openclaw --skill skill-creator -a claude-code. The skill lands at ~/.claude/skills/skill-creator/SKILL.md.
What does skill-creator do?
It helps you author a new skill or rework an existing one: map behaviour into branches, choose the invocation mode, lay out resources, then validate the result.
Which frontmatter fields are required?
name and description. The rest — metadata, homepage, license, allowed-tools, user-invocable, disable-model-invocation, command-dispatch, command-tool, command-arg-mode — are worth adding only when they change how the skill runs or how it is found.
Source text
SKILL.md · MIT
---
name: skill-creator
description: "Author or review AgentSkills: create, repair, validate, or restructure SKILL.md files and bundled resources."
---
# Skill Creator
## Workflow
1. 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.
2. 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.
3. Structure the skill.
- Map shared ordered procedure to `SKILL.md`; end every step with a checkable completion criterion and finish with verification.
- Keep routing conditions in `description`; start the body with execution.
- Map branch-only detail to `references/`, repeatable helpers to `scripts/`, output resources to `assets/`, and optional UI metadata to `agents/`.
- **Done when:** every planned resource has one purpose and a direct pointer from `SKILL.md`.
4. Draft and persist.
- Live workspace skill: use `skill_workshop` to create or revise a pending proposal; keep live files unchanged until apply.
- Repository-owned skill source: use the repository's normal edit and review workflow.
- **Done when:** the proposal or source diff implements every branch from step 1 and contains every resource from step 3.
5. Validate.
- Run `python {baseDir}/scripts/quick_validate.py <skill-directory>` and execute every touched helper's focused test.
- **Done when:** frontmatter passes, resource pointers resolve, and every touched helper passes its focused test.
## Frontmatter
Required: `name`, `description`.
OpenClaw also supports `metadata`, `homepage`, `license`, `allowed-tools`, `user-invocable`, `disable-model-invocation`, `command-dispatch`, `command-tool`, and `command-arg-mode`. Add optional fields only when they change runtime behavior or discovery.
© openclaw · MIT · openclaw/openclaw