Install any skill in seconds. Free to start, no credit card required.
Get Started Free →lukerenton/my-skill
What this skill does and when to use it. Claude reads this to decide relevance. Include keywords users would naturally say.
Passed 19 of 20 test cases with the skill, and 8 of 20 without it.
and 12 more in the full report
12 fixed9 passed either way1 still failing0 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 10 test cases the skill fixed. Same model, same prompt, with and without the skill.
Write the variable placeholder used inside skill body text to refer to the absolute path of the current skill package directory.
| Checked | Without skill | With skill |
|---|---|---|
| Uses ${CLAUDE_SKILL_DIR} syntax | Missed | Passed |
The instructions your model reads when the skill loads.
These two fields are the only ones required. name must be lowercase with hyphens, max 64 characters, and match the parent directory name. description is what Claude reads at startup to decide when the skill is relevant (max 1024 characters).
Add any of these to the --- block above to customise behaviour:
| Field | Example | Purpose |
|---|---|---|
argument-hint | [issue-number] | Hint shown during autocomplete to indicate expected arguments |
disable-model-invocation | true | Prevent Claude from auto-loading. User must type /name explicitly. Use for deploys, sends, destructive ops |
user-invocable | false | Hide from the / menu. Claude can still load it automatically. Use for background knowledge |
allowed-tools | Read, Grep, Bash(npm *) | Tools Claude can use without asking permission. Space-delimited, supports patterns |
model | claude-sonnet-4-6 | Override the model when this skill is active. Useful for cost control |
context | fork | Run in an [isolated subagent](^A separate Claude instance with its own context. The skill content becomes the subagent's system prompt). Skill content becomes the subagent's prompt |
agent | Explore | Which subagent runs when context: fork. Built-in: Explore, Plan, general-purpose, or custom from .claude/agents/ |
license | Apache-2.0 | License name or reference to a bundled LICENSE file |
compatibility | Requires git, docker | Environment requirements (max 500 chars) |
metadata | key-value pairs | Arbitrary metadata (author, version, etc.) |
Everything below the frontmatter is the instruction body. Claude reads this when the skill is activated. Write whatever helps Claude perform the task. There are no format restrictions.
Good body content includes:
[Placeholders](^Variables in your SKILL.md that get replaced with real values before Claude sees the content) are replaced with real values before Claude sees the content:
| Placeholder | Resolves To |
|---|---|
$ARGUMENTS | Everything the user typed after the skill name |
$ARGUMENTS[N] or $N | A specific argument by index (0-based) |
test cases passed, vs 8 / 20 without
Published skills whose descriptions closely match this one, with their headline benchmark lift.
More skills from the same source and nearby in the registry, with their headline benchmark lift.