SKILL.md file with YAML frontmatter and markdown instructions.
For how skills are loaded and prioritized, see Skills.
Create your first skill
1
Create the skill directory
Skills live in your workspace. Create a new folder:
2
Write SKILL.md
Create
SKILL.md inside that directory. The frontmatter defines metadata,
and the markdown body contains instructions for the agent.3
Add tools (optional)
You can define custom tool schemas in the frontmatter or instruct the agent
to use existing system tools (like
exec or browser). Skills can also
ship inside plugins alongside the tools they document.4
Load the skill
Start a new session so FluffBuzz picks up the skill:Verify the skill loaded:
5
Test it
Send a message that should trigger the skill:Or just chat with the agent and ask for a greeting.
Skill metadata reference
The YAML frontmatter supports these fields:Best practices
- Be concise — instruct the model on what to do, not how to be an AI
- Safety first — if your skill uses
exec, ensure prompts don’t allow arbitrary command injection from untrusted input - Test locally — use
fluffbuzz agent --message "..."to test before sharing - Use ClawHub — browse and contribute skills at ClawHub
Where skills live
Related
- Skills reference — loading, precedence, and gating rules
- Skills config —
skills.*config schema - ClawHub — public skill registry
- Building Plugins — plugins can ship skills