Can it automatically update my files?

Yes, it can auto-fix minor issues like formatting and vague language instantly, but it always asks for approval before making substantive structural or meaning-based changes.

Where does the skill look for documents by default?

If no path is provided, it intelligently looks for the most recent files within the docs/brainstorms/ and docs/plans/ directories.

Does it rewrite the entire document from scratch?

No, the skill is designed to refine and improve existing content rather than complete rewrites, ensuring user intent and original context are preserved.

When should I use the Document Review skill?

It is best used immediately after a brainstorming session or a planning phase to ensure the resulting document is specific enough for implementation.

How does this skill help with project scope?

It applies YAGNI (You Aren't Gonna Need It) principles to identify and suggest the removal of hypothetical features that add unnecessary complexity to your plans.

Document Reviewer

Name: Document Reviewer
Author: gvkhosla

bygvkhosla

•

内容管理

Refines brainstorm and planning documents to ensure technical clarity, specificity, and adherence to minimal viable scope.

The Document Reviewer skill streamlines the transition from ideation to implementation by performing structured assessments of brainstorm and planning files. It identifies vague language, unstated assumptions, and unnecessary complexity (YAGNI), providing automated fixes for minor issues and guided refinements for major structural improvements. By scoring documents on clarity and completeness, it ensures that your development projects start with a high-quality, actionable foundation without the overhead of manually auditing every planning document.

主要功能

0135 GitHub stars

02Critical improvement highlighting to focus on the most impactful document changes

03Identification of unstated assumptions and hypothetical scope creep

04Structured review workflow specifically for docs/brainstorms and docs/plans

05Real-time inline document updates for formatting and minor fixes

06Automated clarity and completeness scoring based on professional standards

使用场景

01Ensuring project documentation reflects validated assumptions from previous discussions

02Auditing a technical plan to remove unnecessary features and reduce scope before coding

03Polishing a brainstorm document to prepare it for a detailed technical plan

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add gvkhosla/compound-engineering-pi document-review

For use in Claude.ai and ChatGPT

Download Skill