08 — Journal
Where we make claims.
Editorial essays on the agent-skill ecosystem. Each post links back into the directory — it's where the auto-generated catalog gets a point of view.
-
How to write a SKILL.md that actually gets adopted
Writing a SKILL.md is easy. Writing one that gets adopted is the part nobody tells you about. We've graded 2,389 of them — here's the playbook the high scorers all converged on.
-
Craft is cheap. Adoption is hard.
1,291 SKILL.md files graded. 249 publish. The gap between those numbers turned out to be more about license, docs, and maintenance than about whether the spec is well-written.