I applied my skill-writing principles to 159 skills using parallel subagents - here's the full breakdown

<!-- SC_OFF --><div class="md"><p>I&#39;ve been building and maintaining an open-source skill registry for Claude Code for a while now. After writing 159 skills and watching how agents actually use them, I&#39;ve landed on a set of principles that consistently make skills better.</p> <p>The 10 principles I follow:</p> <ol> <li>Don&#39;t state the obvious - push Claude out of its defaults, not into them</li> <li>Gotchas section = highest ROI content in any skill</li> <li>Skills are folders, not files - use references/, scripts/, assets/</li> <li>Don&#39;t railroad - guidelines over rigid step sequences</li> <li>First-time setup via config.json in the skill folder</li> <li>Description field is a trigger condition, not a summary</li> <li>Give skills memory - logs, JSON, SQLite between runs</li> <li>Ship scripts alongside prose - fetch_events.py &gt; 200 lines of explanation</li> <li>On-demand hooks - /careful blocks destructive commands only when invoked</li> <li>Skills compose - reference by name, Claude invokes if installed</li> </ol> <p>Repo: <a href="http://github.com/AbsolutelySkilled/AbsolutelySkilled">github.com/AbsolutelySkilled/AbsolutelySkilled</a> - 159 skills, all open source, installable via npx skills add</p> <p>Curious what skills you all are building and what patterns have worked for you.</p> </div><!-- SC_ON --> &#32; submitted by &#32; <a href="https://www.reddit.com/user/maddhruv"> /u/maddhruv </a> <br/> <span><a href="https://www.reddit.com/r/ClaudeAI/comments/1rwzbcv/i_applied_my_skillwriting_principles_to_159/">[link]</a></span> &#32; <span><a href="https://www.reddit.com/r/ClaudeAI/comments/1rwzbcv/i_applied_