Skills

Skills teach the agent when and how to use tools. Each Skill is a directory containing SKILL.md that provides operational procedures and guidance for specific domains.

How Skills Work

1. Discover

   Runtime scans for SKILL.md files recursively from configured skill roots. By default it includes workspace.path/skills/; for the local starter this resolves to ~/.mushroom_agent/skills/.

2. Select

   When user request clearly matches a Skill, the agent decides whether to enable it.

3. Read

   Once matched, the agent reads the corresponding SKILL.md via the read tool.

Skills Directory Structure

~/.mushroom_agent/
└── skills/
    └── skill-name/
        ├── SKILL.md (required)
        ├── scripts/          # executable scripts
        ├── references/       # reference documentation
        └── assets/           # asset files

SKILL.md Structure

---
name: skill-name
description: Skill description, explaining when to use this Skill
---

# Skill Name

## Operational Guidance

Frontmatter fields:

Field	Required	Description
name	Yes	Unique identifier
description	Yes	Description shown to the agent

Related

• Creating Skills
• Skills Config
• Skills Hub