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:

RuleAgent Skills specClaude apps & API upload
The file is named SKILL.mdFailsWarns
One SKILL.md per skillWarnsNotes it
The zip holds one folder named after the skillNot checkedFails
At most 30 MB in totalNot checkedFails
The skill sits one folder below its skills folderWarnsNot checked
The name avoids the reserved words anthropic and claudeWarnsFails
The description has no angle bracketsWarnsFails
The description fits the 200 characters claude.ai statesNot checkedNotes it
The description says when to use the skillNotes itNot checked
The description is in the third personNot checkedNotes it
The description leads with the main jobNotes itNot checked
Only the six spec fieldsWarnsFails
Has a license fieldNotes itNot checked
metadata maps text keys to text valuesFailsWarns
allowed-tools is one space-separated stringWarnsNotes it
No install records in metadataWarnsNot checked
The body is at most 500 linesWarnsNotes it
The body is under about 5,000 tokensWarnsNotes it
MCP tools are named Server:toolNot checkedNotes 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).