Skill Pack Format

A skill pack is a directory with a SKILL.md at the root. Additional files (scripts, templates, examples) are bundled alongside it.

SKILL.md frontmatter

---
name: my-skill             # required — must match pack slug
description: One line.     # required
allowed-tools:             # optional — list of tool tokens
  - Bash
  - Read
model: claude-opus-4-7     # optional — preferred model
hooks:                     # optional — Claude Code lifecycle hooks
  PreToolUse:
    - Bash
---

# Body

Your instructions follow the frontmatter.

Allowed tool tokens

Only the following tokens are permitted in allowed-tools:

• Bash
• WebFetch
• WebSearch
• Write
• Edit
• Read
• Glob
• Grep

MCP tool tokens (mcp__*) are not supported.

commands_manifest

Commands annotated in the body are extracted and stored in commands_manifest. Two annotation forms are supported:

# Inline (single backtick with ! prefix):
Run `!git diff HEAD` to see changes.

# Fenced block (triple backtick with ! language):
```!
git log --oneline -20
```

These are surfaced on the pack detail page so buyers can see what commands the skill runs.

Pack size limit

Total pack size must not exceed 500 KB. The secret scanner will reject any file containing API keys or tokens.