skills

Skills that carry work from fuzzy plan to landed branch, on any project. One flow with a fast path and a deep dial.

Install

Two paths, both for Claude Code. Pick one: installing both loads every skill twice.

npx skills:

npx skills add pwguler/skills

Plugin (updates via version):

claude plugin marketplace add pwguler/skills
claude plugin install pwguler-skills

Or in a Claude Code session:

/plugin marketplace add pwguler/skills
/plugin install pwguler-skills

Restart Claude Code after installing.

Update

npx skills:

npx skills update

Plugin:

claude plugin update pwguler-skills

Restart Claude Code after updating.

The loop

The base suite (drill → implement → verify → land) implements the run-until-done loop: a bounded goal, a maker/checker cycle, an exit only on proven criteria. Fast path: an obvious task skips the interview; one sentence is the spec, once it passes the fork test. If verify fails twice, the task was lying: route back through drill. /deep is user-only and turns every fast path off for the session.

flowchart TD
    idea([idea or codebase friction]) --> drill["1. drill: settle the plan"]
    drill -- "goal, non-goals, acceptance criteria" --> spec[("docs/specs/*.md")]
    arch["architecture: settle a deepening"] -- "deepened interface, surviving tests" --> spec
    drill -- "tree too big for one session" --> draft[("spec as draft: open decisions")]
    draft -- "sessions resolve decisions one at a time" --> spec
    spec --> impl

    subgraph cycle["2. the maker / checker cycle"]
        impl["implement (maker): failing test, minimum code"] --> verify["verify (checker): reject by default, quotes evidence"]
        verify -- "criterion fails" --> impl
        impl -. "bug: root cause first" .-> debug
        debug -.-> impl
    end

    verify -- "every criterion proven" --> land["3. land: fresh-eyes gate"]
    impl -- "3 failed attempts on one slice" --> you(["escalate to you"])
    land -- "residue to ADRs, CONTEXT.md, ARCHITECTURE.md; spec kept unless dropped" --> done([branch closed])

Loading

The documents the suite maintains, all created lazily with no setup step: CONTEXT.md (domain glossary, born from the first resolved term), ARCHITECTURE.md (the system as it is), DESIGN.md (the look: tokens, type, color, spacing; prototype grounds in it), docs/adr/ (hard-to-reverse decisions), docs/specs/<slug>.md (the loop's steering artifact; a spec kept after its branch is a record of why the code looks the way it does). These are shared project artifacts: committed, human-readable, reviewed in PRs. Claude's auto-memory is per-user preference and never replaces them; neither writes to the other.

When to use what

Moment	Skill
New plan, feature, or design	drill
A design fork needs a throwaway to react to	prototype
Implementing a settled plan	implement
Bug or unexpected behavior	debug
About to claim done, fixed, or passing	verify
Is it good, not just correct	rubric
Starting a codebase or area, or existing code fights you	architecture
Reading legwork	research
Branch done, needs merging or a PR	land
Independent failures or tasks, two or more	parallel
Authoring or editing anything an agent reads	write-skill
A task finished, you want the short version	tldr
Risky or ambiguous work, full rigor wanted	deep

core-interview is internal support: drill and architecture run it, you do not invoke it directly.