mdpantry / SKILL.md starter
SKILL.md starter
SKILL.md is the one required file of an agent skill: YAML frontmatter with a name and a description, then the instructions an agent loads when the skill applies. This starter passes the specification's rules for both fields, with the name and the description left for you to write.
Published . Updated .
The file
Email it to myself Download SKILL.md Open the raw file
8 blanks for you to fill
- one sentence: what this skill is for
- the first thing the agent does, for example: list the pull requests merged since the last tag
- the next step
- how the agent checks its own result before it reports back
- what the person asks for
- what a good answer looks like
- what to do when the input is missing or empty
- what this skill must never do
The download is the file alone: put it at my-skill/SKILL.md in your project. Or save it from a terminal:
curl -fsSL https://mdpantry.com/s/st_shjaxurgoqng23jq/raw --create-dirs -o my-skill/SKILL.md
--- name: my-skill description: Replace this with what the skill does and when to use it, in the words a person would use when they need it. For example, Formats release notes from merged pull requests. Use when the user asks for release notes or a changelog. --- # My skill `<one sentence: what this skill is for>` ## Steps 1. `<the first thing the agent does, for example: list the pull requests merged since the last tag>` 2. `<the next step>` 3. `<how the agent checks its own result before it reports back>` ## Example - Input: `<what the person asks for>` - Output: `<what a good answer looks like>` ## Edge cases - `<what to do when the input is missing or empty>` - `<what this skill must never do>`
What does a SKILL.md need?
A SKILL.md opens with a block of YAML frontmatter: a line of ---, the fields, a line of ---, and then the instructions in Markdown. The Agent Skills specification requires two fields in it, name and description. Of 112,727 distinct SKILL.md files the registry has saved, from 6,259 public repositories, 99% have frontmatter it could read, 98% have a name and 98% have a description. Among the 15,156 in repositories with 1,000 stars or more, it is 98%, 97% and 96%.
The fields the specification names
descriptionrequired110,512 98%namerequired110,143 98%metadataoptional27,561 24%licenseoptional21,209 19%allowed-toolsoptional12,087 11%compatibilityoptional7,541 6.7%
Where files break its rules
- No frontmatter the registry could read1,672 1.5%
- A name that is not lowercase letters, digits and single hyphens, or is over 64 characters2,393 2.1%
- A name that differs from its folder's name6,344 5.8%
- A description over 1,024 characters962 0.9%
Beyond the six, the fields files carry most are version (12,604), argument-hint (7,965), user-invocable (5,969), disable-model-invocation (5,355), author (5,317), tags (4,545). The specification does not name them.
Counted by the registry that serves this pantry, with no model in the count, from its saved copies as they stood on : 112,727 distinct files (identical files count once) of 127,412 saved. A file has frontmatter when the registry read a YAML block with at least one field from the top of it. The rules are the Agent Skills specification's as read on 18 November 2026: a name of 1 to 64 characters, lowercase letters, digits and hyphens, matching its folder; a description of 1 to 1,024 characters. A name is compared with its folder only for the 109,410 files that sit in one. Not live GitHub, and not every repository on GitHub, only the ones the registry has found.
If you want your agent on modelranch, a deals network for agents, the instructions are at modelranch.com/AGENTS.md. The file above does not mention it.
What to change
- Change name to your skill's name: lowercase letters, numbers and single hyphens, at most 64 characters, not starting or ending with a hyphen.
- Name the folder exactly the same as the name field. In Claude Code a project skill lives at .claude/skills/<name>/SKILL.md.
- Rewrite the description: what the skill does and when to use it, at most 1024 characters, with the words a person would use when they need it.
- Replace the placeholders in angle brackets. Keep the file under 500 lines and move long reference material into a references/ folder beside it.
Audit
Grade A on the registry's safety audit: all 17 checks passed.
The audit checks that the file is safe to commit, not what an agent does with it. The 17 checks:
- Frontmatter block present
- Frontmatter declares a name
- Frontmatter declares a description
- Size between 200 bytes and 200 KB
- No zero-width or bidi control characters
- No instruction hidden inside an HTML comment
- No link to an exfiltration or paste host
- No credential-shaped string
- No instruction to send local credentials anywhere
- No text hidden with inline styles
- No prompt-injection phrasing
- No curl or wget piped into a shell
- No recursive delete of root, home or parent
- No instruction to read or print local credentials
- No base64 blob over 200 characters
- No link to a raw IP address
- No script tag
Other starters
Sources
SKILL.md in the wild
The 3 most-starred public repos the pantry has saved that keep their own SKILL.md, as its saved copies stood on . Each jar is that repo's file, the one nearest its root, to scale with this starter: a jar's height is its length, the honey its written lines. Tap a jar for that repo's whole pantry.
- morluto/
rea 458,922 stars 118 lines - obra/
superpowers 316,989 stars 316 lines - affaan-m/
ecc 302,187 stars 153 lines
- SKILL.md This starter 24 lines
Commit yours and your repo gets its own shelf at mdpantry.com/<you>/<repo>: swap github.com for mdpantry.com in any public repo's address. Its README can wear the shelf as a badge. This is the badge for morluto/rea: