Add SKILL.md pattern idea for discoverable agent tools

This commit is contained in:
2026-04-07 20:27:58 +00:00
parent 590c88ecef
commit 42870c7c1f

View File

@@ -16,6 +16,30 @@ View or live-edit an agent's persona via IRC. "Make the worker more sarcastic" w
### !pause / !resume <agent>
Temporarily mute an agent without destroying it. Agent stays alive but stops responding. Useful when you need a channel to yourself.
## Skill System (inspired by mitsuhiko/agent-stuff)
### SKILL.md pattern for agent tools
Replace hardcoded tools in agent.py with a discoverable skill directory. Each skill is a folder with a SKILL.md (description, parameters, examples) and a script (run.sh/run.py).
```
~/.fireclaw/skills/
web_search/
SKILL.md # name, description, parameters — parsed into tool definition
run.py # actual implementation
fetch_url/
SKILL.md
run.py
git_diff/
SKILL.md
run.sh
```
Agent discovers skills at boot, loads SKILL.md into Ollama tool definitions, invokes scripts on tool call. Adding a new tool = drop a folder. No agent.py changes needed.
Could also support per-template skill selection — coder gets git/code skills, researcher gets search/fetch skills, worker gets everything.
Reference: https://github.com/mitsuhiko/agent-stuff — Pi Coding Agent skill/extension architecture.
## Agent Tools
### Web search