self-critique-and-revise

Critique draft engineering artifacts against a locked rubric and produce a revised draft.

6|Updated Jul 10, 2026
One-click install
npx skills add https://github.com/Mozurok/fhorja.dev --skill self-critique-and-revise-mozurok
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: self-critique-and-revise
Source: https://github.com/Mozurok/fhorja.dev/tree/main/.claude/skills/self-critique-and-revise
Command: npx skills add https://github.com/Mozurok/fhorja.dev --skill self-critique-and-revise-mozurok

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Draft planning artifacts like implementation plans, slice specs, and PR packages often contain vague exit criteria, scope creep, or missing risk notes, and re-running the authoring command to fix them is expensive. This Skill runs a single structured critique pass against a fixed rubric and emits a revised draft, so draft quality improves without restarting the upstream workflow. ## Core Features & Use Cases - Locked per-artifact rubrics: Applies a fixed 7-criterion rubric for IMPLEMENTATION_PLAN.md, SLICES/*.md, or PR_PACKAGE.md, scoring each criterion PASS, FAIL, or WEAK with reasoning. - Conservative revision: Rewrites only FAIL and WEAK items fixable from existing context, preserves passing content verbatim, and defers judgment calls to a Not applied section. - Workflow routing: Detects unsupported artifacts and emits NO_OP_TRACE with routing to the right command (review-hard, sync-task-state, direction-adjust). - Use Case: After drafting an implementation plan whose slices lack verifiable exit criteria, run this Skill to get a criterion-by-criterion critique plus a revised plan with concrete exit criteria, while deferring the question of splitting slice 03 to the user. ## Quick Start Ask the AI to run self-critique-and-revise on the IMPLEMENTATION_PLAN.md in the active task folder and show the critique plus revised draft for approval.

Frequently Asked Questions about self-critique-and-revise

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I improve a draft implementation plan without regenerating it?▼

Run a structured critique against a fixed rubric covering objective clarity, slice independence, exit criteria, dependencies, sequencing, risk, and slice size. The revision rewrites only failing criteria and preserves passing sections verbatim, which is cheaper than re-running the authoring command.

What artifacts can this self-critique skill review?▼

It accepts exactly three artifact types: IMPLEMENTATION_PLAN.md, SLICES/<NN>-*.md, and PR_PACKAGE.md, each with its own locked 7-criterion rubric. Other files like TASK_STATE.md or DECISIONS.md are rejected with a NO_OP_TRACE and routing to the appropriate command.

How is self-critique different from a code review command?▼

Self-critique revises draft planning artifacts, while review-hard only judges engineering risk without producing a revision. Direction-adjust records mid-task corrections and post-review-pivot handles external feedback; neither rewrites the artifact itself.

When should I not use self-critique and revise?▼

Skip it when the artifact is not in the locked set, when the problem is operational state rather than draft quality, when external feedback drives the change, or when no draft exists yet. It also refuses to revise when the artifact's intent itself is wrong, routing to direction-adjust instead.

Does the revision get applied automatically?▼

No. In Plan mode the revised draft is PROPOSED by default and the user reviews both the critique and the revision before anything is applied. Changes are applied directly only in Agent mode, and git remains the recovery path.