← ClaudeAtlas

skill-builderlisted

Use when the user is designing, reviewing or debugging a Claude Code skill and needs the judgment behind a good SKILL.md — should this even be a skill (vs CLAUDE.md / subagent / hook / MCP), why a description does or doesn't trigger, how to keep the body skimmable, how to package it. Carries the opinionated principles plus a review checklist. Trigger on "review my SKILL.md", "why doesn't my skill trigger", "principles of a good skill", "should this be a skill or a hook", "is my skill description good", even when the word "skill" is only implied. NOT for interactive scaffolding from scratch (use Anthropic's Skill Creator), nor for general coding.
ohugonnot/claude-skills · ★ 0 · AI & Automation · score 72
Install: claude install-skill ohugonnot/claude-skills
# Skill Builder — the principles behind a skill that triggers and stays focused > For interactive scaffolding, evaluation and benchmarking of a skill, use Anthropic's official **Skill Creator** (claude.com/plugins/skill-creator). This skill is the complementary **judgment layer**: the opinionated principles that make a skill trigger reliably and stay focused, plus a review checklist and the packaging path. Use it to design, review, or debug a skill, not to generate boilerplate. ## The root virtue: predictability A skill exists to pull determinism out of a stochastic system. What you make repeatable is the **process**, not the output — the agent should take the same approach every run, even when the result differs. Design the procedure; don't script the answer. Two tests fall out of this: - **Completion criteria the agent can check.** The skill must give it a way to tell *done* from *not-done* — otherwise it stops early and calls it finished. - **One leading word.** Anchor the skill on a single concept the model already knows well (e.g. *tracer bullet*, *receipt*, *lesson*, *seam*) and repeat it in the name, the description and the body. A word the model thinks with anchors both *triggering* and *execution* — far more than a phrase it has to decode. ## First: is a skill even the right tool? Claude Code has five extension primitives. Pick the one that fits before writing anything. - **Skill** — a reusable workflow or body of knowledge, pulled in **when its description ma