zpyoung

32 mods across 1 repository, 6 stars between them.

typed-artifacts

25

zpyoung/quirk

Skill Claude CodeCodex

Use when about to write hedging language like "pre-existing", "out of scope", "future work", "skipped for brevity", or "architectural concern" — instead, route the observation to a typed artifact (BUGS.md, DEFERRED.md, TESTBACKLOG.md, proposals.md) or an ADR. Also use when the user invokes /quirk:artifacts: commands…

6 9d ago A 102 tokens

using-git-worktrees

26

zpyoung/quirk

Skill Claude CodeCodex

Use when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory selection and safety verification.

6 9d ago A 35 tokens

using-quirk

27

zpyoung/quirk

Skill Claude CodeCodex

Use when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions.

6 9d ago A 30 tokens

zpyoung/quirk

Skill Claude CodeCodex

Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always.

6 9d ago A 43 tokens

writing-plans

29

zpyoung/quirk

Skill Claude CodeCodex

The planning rubric the execution skills run in-context at the start of a run — turns the tech spec (tech.md) when present, else the logic spec / requirements, into a task breakdown (contracts, acceptance, parallelism) before code.

6 9d ago A 52 tokens

zpyoung/quirk

Skill Claude CodeCodex

Use when writing or revising a human-facing technical document — README, guide, ADR, PR description, changelog — or when asked to tighten, shorten, or declutter one ("tighten this", "too long", "hard to scan", "make this scannable"). Separates what the reader's decision depends on from detail they do not want, cutting…

6 9d ago A 112 tokens

writing-skills

31

zpyoung/quirk

Skill Claude CodeCodex

Use when creating, editing, or testing a Claude Code skill — writing SKILL.md and its frontmatter/description, choosing skill vs command vs subagent vs CLAUDE.md, fixing a skill that won't trigger, or deciding how strictly to test one. Covers activation (getting a skill to fire) and execution (getting it right once…

6 9d ago A 74 tokens

writing-tech-spec

32

zpyoung/quirk

Skill Claude CodeCodex

The rubric the execution skills run in-context — only when the work warrants it — to author the code-anchored tech spec from the approved logic spec, before planning.

6 9d ago A 38 tokens