# plan-critics

Reviews implementation drafts and task tickets using parallel critic subagents. It spots security gaps, complexity traps, and conflicting library rules.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 651 installs
- Author: timschoch
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/timschoch/skilly/tree/HEAD/bundles/workflow/skills/plan-critics/SKILL.md
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/skills/plan-critics

## What it does

This workflow reviews an implementation document or issue ticket from distinct viewpoints. The coordinator scans specification files inside `critics/*.md`. It always applies general checks for edge cases, architecture bloat, security weaknesses, and excessive complexity. When the text references specific frameworks like Next.js, Postgres, or Vercel, corresponding tech reviewers join the active pool.

Reviews run across bundled subagents in waves capped at four concurrent jobs. Inside each subagent, write access is blocked: `Write`, `Edit`, and `Bash` cannot be executed, leaving only inspection utilities such as `Read`, `Grep`, and `Glob`. Findings are parsed, deduplicated, and organized into an aggregated table that flags direct disagreements between different critics.

You must run this skill at the session root. Invoking it inside an existing subagent fails because it relies directly on the `Task` tool. When no explicit target path or issue number is passed, it falls back to the active plan session or the latest file saved in `~/.claude/plans/`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add timschoch/skilly --skill plan-critics -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/plan-critics/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/plan-critics/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add timschoch/skilly --skill plan-critics -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/plan-critics/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add timschoch/skilly --skill plan-critics -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/plan-critics/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install timschoch/skilly plan-critics
```

2. **Manually: put the files in place**
- File: `.github/skills/plan-critics/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add timschoch/skilly --skill plan-critics -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/timschoch/skilly --path bundles/workflow/skills/plan-critics
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/plan-critics/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add timschoch/skilly --skill plan-critics -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/timschoch/skilly/tree/HEAD/bundles/workflow/skills/plan-critics/SKILL.md

## When to use it
- spot security flaws and logic gaps before writing code
- catch scope creep and unnecessary complexity in task descriptions
- detect conflicting architectural recommendations between stack components
- audit edge cases before finalizing implementation tickets

## Example prompts
- /plan-critics ./plans/auth-migration.md
- /plan-critics 142
- Critique this implementation plan for blind spots

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

From the same set: [timschoch/skilly](https://affpapa.org/en/nevibecode/by/timschoch/skilly.md) — 16 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md