Skill Authoring

Skills are reusable prompts for Claude Code. They are defined as SKILL.md files and version-controlled.

SKILL.md structure

---
name: my-skill
display_name: My Skill
description: A one-line description of the skill
---

Write your prompt body here.

Frontmatter

Field	Required	Description
name	Yes	Slug identifier (/^[a-z0-9-]+$/)
display_name	Yes	Human-readable display name
description	Yes	One-line description of the skill

Prompt body

Written in Markdown format. Claude Code receives this text as instructions and executes accordingly.

Skill management

Local deployment

Skills are placed at ~/.claude/skills/<name>/SKILL.md on the minion.

# List locally deployed skills
minion-cli skill list --local

Syncing with HQ

# List skills on HQ
minion-cli skill list

# Fetch a skill from HQ and deploy locally
minion-cli skill fetch <name>

# Push a local skill to HQ (new version auto-created)
minion-cli skill push <name>

Accompanying files

Skills can include template and configuration files alongside SKILL.md. All files in the same directory are managed as part of the skill.

~/.claude/skills/my-skill/
├── SKILL.md           # Prompt body
├── template.html      # Template file
└── config.json        # Configuration file