Does it work directly with GitHub workflows?

Yes, it is specifically designed to format its final output as PR review comments or issue responses, complete with quoted lines and threaded sections.

Can it suggest next steps for the proposer?

Yes, after synthesizing all feedback, the skill can generate a concrete list of action items to help the author refine and improve the proposal.

How does the chunking strategy work?

The skill uses a smart hybrid approach, splitting documents by headers, topic transitions, or list items to ensure each section is focused enough for detailed review.

What document formats does this skill support?

It handles local Markdown files, GitHub PRs, issues, gists, and generic text exports from tools like Google Docs.

Is the feedback output customizable?

Absolutely. While the skill predicts likely reactions (Clarification, Concern, Approval, Suggestion), it allows users to provide custom feedback for every section.

Smart Proposal Review

Name: Smart Proposal Review
Author: petekp

bypetekp

0•

Collaboration Tools

Facilitates structured, methodical reviews of technical designs and feature requests through an interactive feedback loop.

The Smart Proposal Review skill transforms Claude into a sophisticated technical reviewer that breaks down complex documents—such as RFCs, product specs, and technical designs—into manageable chunks. It employs a multi-phase workflow that includes intelligent document segmenting, predictive reaction modeling, and an interactive feedback loop to ensure no detail is overlooked. By synthesizing user input into categorized themes and generating output tailored to specific platforms like GitHub or local Markdown, it streamlines the collaboration process and ensures feedback is actionable and professional.

Key Features

01Automated feedback synthesis with overall sentiment analysis

02Source-aware output generation for GitHub PRs, Issues, and Markdown

03Intelligent hybrid chunking for long documents based on headers and topics

04Predictive reaction modeling with multiple choice feedback options

05Actionable next-steps generation for document proposers

060 GitHub stars

Use Cases

01Reviewing complex Technical Design Documents (TDD) or RFCs

02Evaluating feature requests for scope, risks, and technical feasibility

03Providing structured feedback on GitHub Pull Requests and Issues

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add petekp/agent-skills proposal-review

For use in Claude.ai and ChatGPT

Download Skill