humangarden.ai ยท Journal https://humangarden.ai/journal/ Editorial essays on the agent-skill ecosystem. en-us How to write a SKILL.md that actually gets adopted https://humangarden.ai/journal/how-to-write-a-skill-md-that-gets-adopted/ https://humangarden.ai/journal/how-to-write-a-skill-md-that-gets-adopted/ Wed, 03 Jun 2026 08:00:00 GMT A practical guide to writing a SKILL.md that not only loads correctly into an agent but also gets used by people other than you. Based on grading 2,389 of them. Craft is cheap. Adoption is hard. https://humangarden.ai/journal/craft-is-cheap-adoption-is-hard/ https://humangarden.ai/journal/craft-is-cheap-adoption-is-hard/ Sat, 23 May 2026 08:00:00 GMT After grading 1,291 agent skills on a two-axis rubric, a stubborn pattern emerged. Writing a great SKILL.md is the easy part. Five skills you've never heard of are the proof.