SKILL.make: Makefile Styled Skill file.
Specification and reference implementation for Makefile-styled Agent Skills.
What is this?
SKILL.make brings the declarative, dependency-driven paradigm of Makefiles to the Agent Skills format. It replaces fuzzy prose with structured logic, turning SKILL.md into a reproducible execution graph.
Why Makefile styled SKILL file?
Token Efficient : Optimized syntax reduces SKILL file size by ~15%, saving costs and context window space. With manual optimization, context size can be reduced by more than 30%.
Dependency Resolution : The harness resolves the DAG (Directed Acyclic Graph) automatically. No more relying on an LLM to "guess" the next logical step.Uses the Target: Dependency + Recipe model to ensure Agents follow a strict execution order without skipping steps.
Highly Composable : Modularize skills by calling targets across different files—just like a professional build system.
Auditability and evolution — Lays the groundwork for auditable and evolvable SKILL implementations.
Rule Definitions
... continue reading