writer-critic-pair
Skill1 starsChanged 5 months agoMITView on GitHub
Use a two-role agent pattern where a writer or implementer creates the artifact and a critic or reviewer independently challenges it before final delivery. Use for complex implementations, risky changes, architecture decisions, high-stakes user communication, ambiguous requirements, security-sensitive work, or any task where same-context self-approval would be too weak. Original task, acceptance criteria, scope boundaries, writer output or diff, validation results, repository conventions, known risks, and time or tool constraints. A handoff with:
In this repository117 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- advanced-orchestrationSkill
- architect-agentSkill
- implementer-agentSkill
- quality-councilSkill
- reviewer-agentSkill
- tester-agentSkill
- authoring-skillsSkill
- api-endpoint-qualitySkill
- async-job-qualitySkill
- auth-qualitySkill
- db-migration-qualitySkill
- frontend-state-qualitySkill
- acceptance-criteriaSkill
- adaptive-flowSkill
- adaptive-prompt-selectionSkill
- adversarial-code-reviewSkill
- architecture-decision-recordsSkill
- brainstormingSkill
- brownfield-spec-enhancementSkill
- bug-fix-lifecycleSkill
- checkpoint-validationSkill
- cicd-integrationSkill
- clarify-before-codeSkill
- claude-code-hooks-packSkill
- code-context-packSkill
- code-intelligence-reviewSkill
- context-policySkill
- context-rich-implementationSkill
- crash-proof-planningSkill
- critique-pass-protocolSkill
- dependency-aware-task-orderingSkill
- deprecation-migrationSkill
- disciplined-diagnosisSkill
- docs-authorSkill
- executing-plansSkill
- external-skillSkill
- finishing-a-development-branchSkill
- git-guardrailsSkill
- goal-driven-executionSkill
- grill-user-before-buildingSkill
- guard-bypass-protocolSkill
- improve-codebase-architectureSkill
- incremental-reviewSkill
- issue-slicingSkill
- lessons-learned-dbSkill
- loop-engineeringSkill
- model-aware-configSkill
- model-weakness-memorySkill
- multi-repo-learningSkill
- orchestration-workflowsSkill
- plan-driven-executionSkill
- plan-from-specSkill
- prd-from-contextSkill
- project-constitutionSkill
- prompt-architectureSkill
- prototype-before-commitmentSkill
- quality-engineSkill
- quality-execution-contractSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 16
Use a two-role agent pattern where a writer or implementer creates the artifact and a critic or reviewer independently challenges it before …
- Distinctive: line 20
Use for complex implementations, risky changes, architecture decisions, high-stakes user communication, ambiguous requirements, …
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Writer-Critic Pair
Purpose
Use a two-role agent pattern where a writer or implementer creates the artifact and a critic or reviewer independently challenges it before final delivery.
When to use
Use for complex implementations, risky changes, architecture decisions, high-stakes user communication, ambiguous requirements, security-sensitive work, or any task where same-context self-approval would be too weak.
Inputs
Original task, acceptance criteria, scope boundaries, writer output or diff, validation results, repository conventions, known risks, and time or tool constraints.
Workflow
- Assign the writer to understand the task, inspect context, propose or implement the smallest correct solution, and report verification honestly.
- Assign the critic to read the original task and evidence independently before reading the writer's summary.
- The critic challenges correctness, assumptions, scope, tests, compatibility, safety, and maintainability.
- The writer responds with a fix plan, applies necessary changes, and records any deferred risks.
- The critic re-reviews the revised artifact or explicitly states why re-review was not possible.
- The final owner synthesizes the result and decides whether to ship, revise, or ask for clarification.
Outputs
A handoff with:
- Task: original goal and constraints.
- Writer output: summary, changed files or artifact, and verification run.
- Critic findings: critical, important, and minor findings with evidence.
- Writer response: fixes applied, deferred items, and rationale.
- Re-review: critic result after fixes.
- Final decision: ship, revise, or ask.
Failure modes
- Writer and critic share the same assumptions and miss the same bug.
- Critic rubber-stamps instead of adversarially checking evidence.
- Roles edit the same files concurrently and create conflicting changes.
- Handoff omits validation results or known limitations.
- Critic blocks on taste rather than task risk.
- Final owner ignores unresolved critical findings.
Verification checklist
- Writer and critic responsibilities are distinct.
- Critic reviewed against the original task, not only the writer summary.
- Findings are severity-ranked and evidence-based.
- Writer response addresses or explicitly defers each critical and important finding.
- Final decision reflects re-review status and residual risk.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

