Agent Skills
Claude apps
How Claude apps finds, installs and reads a skill, from its own docs, checked 26 Oct 2026.
Where it looks for skills
In Claude apps, skills live in your account rather than in a folder on your computer: you upload each one as a zip.
From Claude apps’s own docs, checked 26 Oct 2026.
Install a skill
- Zip the skill’s folder so the zip opens to that folder, then upload it in Claude apps, as The skill folder shows.
- Keep the folder named exactly as the name field in its SKILL.md, as The skill folder explains.
- On qai.io/skills, every skill’s page has the steps for Claude apps, starting from Install skills in Claude apps.
Fields it reads
Only the six fields every SKILL.md can hold; its docs name no fields of its own.
SKILL.md sets out the six fields and their limits.
How the format check reads it
The format check on qai.io/skills reads a skill for Claude apps as Claude apps & API upload: Uploading to claude.ai or the Claude API, or packaging with Anthropic's script, accepts only the six spec fields and stops on anything else.
Where that differs from the Agent Skills spec row, rule by rule:
| Rule | Agent Skills spec | Claude apps & API upload |
|---|---|---|
| The file is named SKILL.md | Fails | Warns |
| One SKILL.md per skill | Warns | Notes it |
| The zip holds one folder named after the skill | Not checked | Fails |
| At most 30 MB in total | Not checked | Fails |
| The skill sits one folder below its skills folder | Warns | Not checked |
| The name avoids the reserved words anthropic and claude | Warns | Fails |
| The description has no angle brackets | Warns | Fails |
| The description fits the 200 characters claude.ai states | Not checked | Notes it |
| The description says when to use the skill | Notes it | Not checked |
| The description is in the third person | Not checked | Notes it |
| The description leads with the main job | Notes it | Not checked |
| Only the six spec fields | Warns | Fails |
| Has a license field | Notes it | Not checked |
| metadata maps text keys to text values | Fails | Warns |
| allowed-tools is one space-separated string | Warns | Notes it |
| No install records in metadata | Warns | Not checked |
| The body is at most 500 lines | Warns | Notes it |
| The body is under about 5,000 tokens | Warns | Notes it |
| MCP tools are named Server:tool | Not checked | Notes it |
Validate a SKILL.md shows what Claude apps will reject in your file, with the fix.
Watch out for
- Skills are uploaded to your account as a ZIP whose top-level folder is the skill, named exactly as its name field.
- Anthropic’s Claude Code docs say an upload fails on any frontmatter key outside the six Agent Skills fields; its help centre also lists a dependencies field.
- Code execution must be on: Settings > Capabilities on Free, Pro and Max, or Organization settings > Plugins & skills on Team and Enterprise.
- Skills you upload stay private to you until you share them.
- Skills enabled on your account also load in Claude Code when it is signed in to the same account (version 2.1.273 or later).