Facilitate methodical review of proposals (technical designs, product specs, feature requests). Use when asked to "review this proposal", "give feedback on this doc", "help me review this RFC", or when presented with a document that needs structured feedback. Handles markdown files, GitHub gists/issues/PRs, and other text formats. Chunks proposals intelligently, predicts reviewer reactions, and produces feedback adapted to the proposal's format.
View on GitHubskills/proposal-review/SKILL.md
February 5, 2026
Select agents to install to:
npx add-skill https://github.com/petekp/agent-skills/blob/main/skills/proposal-review/SKILL.md -a claude-code --skill proposal-reviewInstallation paths:
.claude/skills/proposal-review/# Proposal Review Methodically review proposals by chunking content, predicting feedback, and producing actionable output for the proposer. ## Workflow ``` ┌─────────────────────────────────────────────────────────────┐ │ 1. INTAKE: Read entire proposal, identify source format │ ├─────────────────────────────────────────────────────────────┤ │ 2. CHUNK: Split into reviewable sections (smart hybrid) │ ├─────────────────────────────────────────────────────────────┤ │ 3. REVIEW LOOP: For each chunk: │ │ • Present chunk content │ │ • Predict 3-4 likely reactions │ │ • Use AskUserQuestion for feedback │ │ • Record response │ ├─────────────────────────────────────────────────────────────┤ │ 4. SYNTHESIZE: Compile feedback, infer overall sentiment │ ├─────────────────────────────────────────────────────────────┤ │ 5. OUTPUT: Generate feedback document matching source │ └─────────────────────────────────────────────────────────────┘ ``` ## Phase 1: Intake Read the entire proposal. Identify: - **Source format**: Local file, GitHub PR/issue/gist, Google Doc export, etc. - **Structure**: Headers, sections, numbered lists, or flowing prose - **Length**: Estimate chunk count (aim for 3-8 chunks for typical proposals) Do not summarize or share initial impressions. Proceed directly to chunking. ## Phase 2: Chunking Strategy Use smart hybrid chunking: | Proposal Structure | Chunking Approach | |-------------------|-------------------| | Clear headers/sections | One chunk per major section | | Large section (>500 words) | Split at natural paragraph breaks | | Small adjacent sections (<100 words each) | Merge into single chunk | | Numbered lists of items | Group 3-5 related items per chunk | | Flowing prose without structure | Split at topic transitions (~300-400 words) | **Chunk ordering**: Present