From 42870c7c1fd3996a58128582a9485aea72904d54 Mon Sep 17 00:00:00 2001
From: ansible <ansible@mymx.me>
Date: Tue, 7 Apr 2026 20:27:58 +0000
Subject: [PATCH] Add SKILL.md pattern idea for discoverable agent tools

---
 IDEAS.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/IDEAS.md b/IDEAS.md
index 02594b6..f424d43 100644
--- a/IDEAS.md
+++ b/IDEAS.md
@@ -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