Field rules
The folder has to match the format, not a paraphrase of it.
Prompt to Skill follows the Agent Skills specification and the install limits Claude publishes on top of it. Anything else in the frontmatter is an error. This page is our checklist, not a copy of those docs.
| Field | Presence | What we enforce |
|---|---|---|
| name | Required | 1–64 characters. Lowercase letters, digits, and hyphens. It cannot start or end with a hyphen, contain `--`, or differ from the folder name. |
| description | Required | 1–1024 characters. It should say what the skill does and when to use it. The file is rejected when this is empty. |
| license | Optional | A short license name, or a pointer to a license file bundled in the skill. Omitted when the source never states one. |
| compatibility | Optional | 1–500 characters when present. Environment requirements such as a product, a package, or network access. Most skills leave it out. |
| metadata | Optional | A map of string keys to string values for extra facts. Nested objects are rejected. Prompt to Skill records generator: prompttoskill.com here. |
| allowed-tools | Optional | One space-separated string of tools the skill may use. Experimental, and only included when the source names tools. |
Install checks that are not extra fields
Claude refuses a name containing anthropic or claude, and it refuses angle brackets in the name or description. Those are install checks. They do not add keys to the frontmatter. A skill can pass the open spec and still fail here, and then we do not call it ready.
Archive shape
The zip contains one directory. That directory is the skill name, and SKILL.md is inside it. A zip with SKILL.md at the root, or with an extra wrapper folder, is rejected. macOS junk such as __MACOSX is ignored. The body after the frontmatter is free Markdown. We warn, and do not fail, when it is empty, longer than 500 lines, or points at a file that is not in the folder.
Names are normalized with Unicode NFKC before the folder is compared, which is how the reference validator treats composed and decomposed accents. Letters outside the English alphabet are allowed when they are lowercase. The site itself stays in English.
Spec: agentskills.io/specification. Claude's authoring notes: Skill authoring best practices.