Skip to content

Skills

Skills fire automatically when Claude encounters matching phrases in conversation. You do not need to invoke them — they activate on their own. You can also trigger them explicitly if you want.

Discipline

These enforce good engineering habits without you having to ask. Together, atomic-tdd and atomic-verify are the loop's objective gate: a test that passes or fails, not a second opinion. That is the difference between a loop that catches its own mistakes and one that talks itself into "done".

SkillFires when you say...What it does
atomic-tdd"let's implement X", "add feature Y", "fix bug Z"Writes a failing test before touching production code.
atomic-verify"done", "fixed", "passing", "ready to merge"Runs verification before letting Claude claim completion. No evidence, no claim.
atomic-debugpastes an error, "broken", "doesn't work", "failing"Drives hypothesis-driven debugging instead of symptom-patching.

Workflow

These handle the craft of committing, reviewing, and documenting.

SkillFires when you say...What it does
atomic-git-discipline"write a commit", "commit message", "open a PR", "PR description", or automatically from ship commandsGenerates a Conventional Commits message. Subject under 50 chars, body only when the "why" is not obvious. Also owns PR titles and bodies: only what the diff can't show, about 120 words max.
atomic-review"review this PR", "code review", "review the diff"Produces compressed review comments. One line per finding: location, problem, fix.
atomic-visual-options"show me options", "mock up variants", "let me see this side by side", "compare these layouts"Renders 2–4 visual variants per decision dimension as a throwaway self-contained HTML file; user picks by typing codes (e.g. A2 B3); chosen option recorded in the design doc. Invoked by /atomic-plan when a design question is visual.

Awareness

These keep Claude and your docs in sync with the project.

SkillFires when you say...What it does
atomic-writing"draft the README", "write the docs", "edit the guide", "write the spec"The one voice for every file the repo ships, from READMEs to specs to agent prompts. Length follows the surface; a diagram beats a paragraph wherever the content has a shape. No marketing language, no AI-tell phrases.
atomic-documentation"doc this change", "what surfaces does this touch"Figures out which docs need updating based on a diff and routes each to the right voice.
atomic-wiki"I want a place for notes/tickets/research", "add a bucket", "add this to my wiki", "wiki this", "what does my wiki know about X", "is my wiki stale", "set up a karpathy wiki"Routes capture-folder intent to atomic wiki bucket add (never a bare mkdir), handles karpathy-realm setup, and answers staleness queries for registered wikis.
atomic-bus"join the bus", "connect to the bus", "message the backend session", "delegate this to the frontend session", "coordinate with the other agent", "watch the room", "halt the room"Joins a named room (atomic bus join) and starts a recv Monitor so peer messages arrive as prompts. Carries the reaction policy: act on messages addressed to you, note FYI traffic, never act unaddressed.

Released under the MIT License.