Skill Protocol
SKILL.md Specification
Basic Format
---
name: my-skill
description: When to use this skill
---
# Markdown Body
Skill instruction content...
Required Fields
| Field | Description |
|---|---|
name | Skill identifier, kebab-case |
description | Brief skill description |
Extension Fields
| Field | Description |
|---|---|
x-astron-category | Category tag |
x-astron-runtime | Runtime requirement |
x-astron-min-version | Minimum version requirement |
Skill Package Structure
my-skill/
├── SKILL.md # Main entry file (required)
├── references/ # References (optional)
├── scripts/ # Scripts (optional)
└── assets/ # Static assets (optional)
File Validation
- Root directory must contain
SKILL.md - File type whitelist
- Single file size limit: 1MB
- Total package size limit: 10MB
- File count limit: 100
Client Installation Directory
Install by the following priority:
./.agent/skills/~/.agent/skills/./.claude/skills/~/.claude/skills/
Next Steps
- Storage SPI - Extend storage backend