Writing Custom Skills

How to extend DragonClaw with your own SKILL.md packages.

Skills are the extension model for DragonClaw.

A skill is a directory that contains one SKILL.md file.

Minimal structure

my-skill/
└── SKILL.md

Place the folder in ~/.dragonclaw/skills/ and restart DragonClaw.

Strong skill design rules

1. Be specific about when the skill should trigger.

2. Include exact API endpoints and parameters.

3. Show the exact tool JSON the model should emit.

4. Define how results should be formatted.

5. Declare auth requirements clearly.

Supported tool types

{"tool": "binance_market", "action": "GET", "endpoint": "/bapi/...", "params": {}}

{"tool": "shell", "command": "curl -s https://api.example.com/data"}

Shell commands have a 30-second timeout and a 1MB output limit.

Testing

1. Put the skill under ~/.dragonclaw/skills/

2. Run dragonclaw skills

3. Start the agent and test a matching prompt

4. Check debug logs if matching fails