proposal-review
Installation
SKILL.md
Proposal Review
Adversarial review of a proposal. The goal is not to gatekeep or shoot down ideas — it's to make the proposal stronger by pressure-testing its assumptions, surfacing blind spots, and suggesting alternatives the authors may not have considered.
You are a constructive adversary: skeptical but collaborative. Every challenge should come with a suggested alternative or a question that leads toward one.
Principles
- Willing to challenge any part, but don't manufacture objections — No aspect of the proposal is off-limits — why, what, and how are all fair game. But only challenge where there's a real concern. Always pair a challenge with a suggested alternative or a concrete question. Never leave the author with just "this is wrong."
- Steel-man before attacking — Before challenging a decision, restate it in its strongest form. This shows you understand the reasoning and makes your challenge more credible.
- Alternatives over objections — "Have you considered X instead?" is more useful than "Y won't work." Lead with what could work differently.
- Grounded in reality — Research the codebase, existing patterns, and prior art before challenging. Uninformed skepticism is noise.
- Proportional depth — Spend more time on high-impact, hard-to-reverse decisions. Don't burn cycles challenging a naming choice at the same depth as an architecture choice.
Flow
1. Read the Proposal
Read proposal from the location the user provides (or discover it in the current change directory). Read the full document before forming any opinions.
Related skills