May 2, 2026
Bot Jobs, Bossy Lists
SKILL.make: Makefile Styled Skill File
People are cheering, roasting, and arguing over turning messy AI instructions into neat step-by-step lists
TLDR: SKILL.make is a new format that turns fuzzy AI instructions into strict step-by-step task lists, with early tests claiming smaller files and more reliable order. The community is split between "finally, some discipline" and "wow, paperwork for robots," which is exactly why people can’t stop talking about it.
A new project called SKILL.make has wandered into the AI builder chat like that ultra-organized friend with a label maker, promising to turn vague agent instructions into tidy, step-by-step lists inspired by old-school Makefiles. In plain English: instead of writing a big blob of guidance and hoping the AI figures out the order, this system lays out what happens first, what depends on what, and what commands to run. Fans in the community are practically doing cartwheels over the promise of smaller files, lower costs, and fewer "why did the bot skip step two?" disasters. The big flex is a reported 15% average size reduction, with some examples shrinking way more.
But of course, the comments did what comments do: instant civil war. Supporters called it the most obvious idea ever, saying AI tools desperately need structure, receipts, and rules instead of mystical prompt poetry. Critics fired back that this risks turning creative workflows into bureaucratic homework, with one camp basically yelling, "Congrats, you reinvented build scripts for robots." The funniest reactions leaned hard into the meme potential: people joked that we’ve entered the era of "Makefile cosplay for AI", while others laughed that developers will do literally anything to avoid writing normal documentation. Even so, the mood is less dismissal than fascinated bickering. Proof-of-concept or not, the crowd seems to agree on one thing: if this helps AIs stop improvising their way into chaos, it might be messy-comment-section gold and genuinely useful too.
Key Points
- •SKILL.make is introduced as a Makefile-styled specification and reference implementation for Agent Skills.
- •The format is described as token-efficient, with an overall reported reduction of about 15% in file size across a tested skill collection.
- •The article says dependency resolution is handled automatically via a DAG using a target-dependency-recipe model to enforce execution order.
- •The specification defines rule types for variables, shell commands, invocable tools, reasoning prompts, conditional logic, and multi-line code snippets.
- •A comparison using the 'Skills for Real Engineers' collection reports total character counts dropping from 66,394 in SKILL.md to 56,387 in SKILL.make, and the project is labeled a proof of concept under the MIT license.