create-skill
Installation
SKILL.md
Create a new skill for the user.
Instructions
-
Determine save location: Check whether the first argument token equals
global.- If it does, save to
~/.claude/skills/<skill-name>/SKILL.md, and treat the remaining tokens as the skill description. - Otherwise, save to
./.claude/skills/<skill-name>/SKILL.md(project scope), and treat all tokens as the skill description.
The command name comes from the directory name (
my-skill/→/my-skill), not from thenamefield. - If it does, save to
-
Decide the skill type — this drives the frontmatter:
- Reference skill (conventions, domain knowledge, style guides): loaded inline alongside the conversation. Leave it model-invocable.
- Task skill (deploy, commit, codegen, multi-step actions): add
disable-model-invocation: trueso it only runs as/nameand Claude never fires it on its own — especially for anything with side effects.
-
Gather information (use arguments if provided, otherwise ask):
- Skill name (directory name → the command)
- Description (most important — see the rule below)
- Body / instructions
- Any optional frontmatter the skill actually needs (see reference.md)