Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →mkurman/write-a-skill
Create new agent skills with proper structure, progressive disclosure, and bundled resources.
Passed 22 of 22 test cases with the skill, and 16 of 22 without it.
and 4 more in the full report
6 fixed16 passed either way0 still failing0 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 6 test cases the skill fixed. Same model, same prompt, with and without the skill.
I'm creating a custom skill for an AI assistant that extracts line items from receipts and formats expense reports. Can you write a proper skill description for it so the agent router knows its capabilities and trigger contexts?
| Checked | Without skill | With skill |
|---|---|---|
| The description is written in third person | Passed | Passed |
| The first sentence describes what the skill does | Passed | Passed |
| The second sentence begins with the exact phrase Use when | Missed | Passed |
The instructions your model reads when the skill loads.
[Minimal working example]
[Step-by-step processes with checklists for complex tasks]
[Link to separate files: See REFERENCE.md]
## Description Requirements
The description is **the only thing your agent sees** when deciding which skill to load. It's surfaced in the system prompt alongside all other installed skills. Your agent reads these descriptions and picks the relevant skill based on the user's request.
**Goal**: Give your agent just enough info to know:
1. What capability this skill provides
2. When/why to trigger it (specific keywords, contexts, file types)
**Format**:
- Max 1024 chars
- Write in third person
- First sentence: what it does
- Second sentence: "Use when [specific triggers]"
**Good example**:
Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when user mentions PDFs, forms, or document extraction.
**Bad example**:
test cases passed, vs 16 / 22 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.