skills/critique/SKILL.md
Run one targeted, read-only architecture or quality critique through a named lens from the shared rubric. Use when: "critique this module", "run an Ousterhout pass", "lens critique", "architecture critique". Trigger: /critique.
npx skillsauth add phrazzld/spellbook critiqueInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Single-lens signal. Not a merge gate, not /code-review, not a parallel bench.
This skill intentionally runs one focused critic lane. It does not satisfy the
shared Roster contract for substantive review, merge-readiness, or delivery claims;
route those to /code-review, /deliver, or the calling skill's roster
contract. If the critique itself requires broader judgment, probe the roster
and dispatch additional specialized provider lanes from the caller before
synthesizing.
Local lane guidance: The critique lane is specialized by lens and target. Keep it read-only, artifact-only, and independent from author reasoning.
--lenses lists available lens names by reading
harnesses/shared/references/lenses.md; do not hardcode the list here.--lens <name> resolves the matching ## <name> block from that rubric.
Unknown lens means stop and print the available names.--target <path> is required for a focused critique. Resolve it against the
invoking repo and read only the files needed to answer.agents/<lens>.md. Lenses are rubrics, not static persona
files.Spawn one fresh read-only critic subagent with:
<lens> to <target> and find production-relevant design,
correctness, test, or operability risksIf the harness cannot spawn a fresh subagent, the primary adopts the exact
lens text for one read-only pass and marks the header
lens-adopted-by-primary. This is a fallback, not fresh-context separation.
## Critique
- Lens: <name>
- Target: <path>
- Evidence read: <files/commands inspected>
- Fresh-context mode: <subagent|lens-adopted-by-primary>
- Findings:
- Finding: <concise claim>
Evidence: <file:line>
Impact: <high|medium|low>
Suggested next step: <smallest useful action>
- Residual uncertainty: <what was not read or could change the verdict>
Findings require file:line evidence. If no finding survives, say so and cite
the files that were read. Do not return Ship, Conditional, or Don't Ship;
that verdict belongs to /code-review.
/critique --lenses/critique --lens ousterhout --target src/auth/critique --lens cooper --target tests/auth.spec.tstesting
Capture one compounding repo-technical learning while a solved problem is still fresh. Use when: after a bug fix, diagnosis, delivery, review, or incident reveals a reusable pattern worth adding to `docs/solutions/`. Trigger: /compound, /capture-learning, /learning.
testing
Route Misty Step factory application capabilities. Use when choosing, auditing, integrating, or operating Canary, Powder, Landmark, Aesthetic, or Bitterblossom: production observability, incidents, health checks, error logging, backlog/work-card state, release intelligence, UI/UX system adoption, or supervised/unsupervised agent dispatch. Trigger: /factory-apps, /factory-stack.
testing
Prove a skill beats no-skill with a falsifiable A/B eval, or retire it. Design, generate, run, and maintain a skill-specific eval: name the one claim the skill must earn, run it skill-on vs raw same-model, grade blind with objective checks first, return a keep/adapt/cut verdict. Use when: "eval this skill", "does this skill help", "prove the skill beats no skill", "write an eval for", "benchmark a skill", "is this skill worth it", "skill A/B", "skill regression test", "generate skill evals". Trigger: /skill-eval, /eval-skill, /prove-skill.
tools
> Template. Copy to `<target-repo>/.agents/skills/<repo>-<domain>/SKILL.md` > and fill every bracketed placeholder from the live target repo. Delete this > line and every other `> ` guidance line before committing. See > `../../references/repo-local-skill-generation.md` for the full process. --- name: <repo>-<domain> description: | [One paragraph: what this skill verifies/runs/operates for <repo>, stated in terms of the repo's real shape (service/CLI/library/etc.), not generic process. En