agent-primitives
Installation
SKILL.md
Declaring and Bounding Agent Primitives
Two ways to fail. Too few tools and the agent invents around the gap — it guesses at the file, makes a confident edit in the wrong place, and asks to commit. Too many tools and the agent drowns picking, burning a thousand tokens trying three misconfigured surfaces before landing on the built-in that worked.
The middle is a discipline of restraint.
What a tool is
A callable surface: a name the agent can address, a typed shape for arguments, a return value it can read. Markdown is not a tool — it is text the agent reads. A test suite is not a tool; the shell that runs it is.
Inventory by intent, not implementation: