Skills

Skills are reusable markdown instruction files that can be assigned to agents. They inject additional context into the agent's system prompt.

Discovery

SwarmClaw automatically discovers skills from:

~/.claude/skills/*/SKILL.md

Each skill directory contains a SKILL.md file with YAML frontmatter:

---
name: Frontend Design
description: Expert frontend design guidelines and patterns
---

## Guidelines

- Use semantic HTML
- Follow accessibility best practices
- Prefer CSS Grid for layouts
...

The name and description fields appear in the SwarmClaw UI. The rest of the markdown content is injected into the agent's system prompt.

Assigning Skills to Agents

1. Open an agent in the Agents sidebar
2. Scroll to the Skills section
3. Toggle on the skills you want this agent to use
4. Save

When the agent runs, selected skill content is appended to the system prompt:

[User Preferences]
[Soul]
[System Prompt]

## Skill: Frontend Design
(skill content here)

## Skill: Code Review
(skill content here)

Refreshing Skills

Click the Refresh button in the skills section to re-scan ~/.claude/skills/. This picks up newly added or modified skills without restarting the server.

Creating Skills

To create a new skill:

1. Create a directory under ~/.claude/skills/:

   mkdir -p ~/.claude/skills/my-skill
   

2. Add a SKILL.md file with frontmatter:

   cat > ~/.claude/skills/my-skill/SKILL.md << 'EOF'
   ---
   name: My Custom Skill
   description: Description of what this skill does
   ---
   
   Your skill instructions here...
   EOF
   

3. Click Refresh in SwarmClaw to discover it