skills.rest
merlyn-huntress
merlyn-huntressCOMMUNITY
Explore all skills by this author →
GitHub

document-review

Automates structural edits and identifies impactful improvements in a given document.

Updated Feb 26, 2026
Search Tags:#planning#refinement#brainstorming#editing#clarity#document review
One-click install
npx skills add https://github.com/merlyn-huntress/compound-engineering-plugin-no-mcp --skill document-review-merlyn-huntress
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: document-review
Source: https://github.com/merlyn-huntress/compound-engineering-plugin-no-mcp/tree/main/plugins/compound-engineering/skills/document-review
Command: npx skills add https://github.com/merlyn-huntress/compound-engineering-plugin-no-mcp --skill document-review-merlyn-huntress

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill addresses the challenge of producing high-quality, clear, and actionable documents by providing a structured review process to identify and rectify ambiguities, scope creep, and unstated assumptions.

Core Features & Use Cases

  • Structured Assessment: Evaluates documents against criteria like clarity, completeness, specificity, and adherence to YAGNI principles.
  • Critical Improvement Identification: Pinpoints the single most impactful change needed for a document.
  • Automated & Approved Changes: Handles minor fixes automatically and seeks approval for substantive edits.
  • Use Case: Before submitting a project plan, use this skill to ensure all requirements are clearly stated, potential scope creep is identified, and the plan is specific enough for the development team to begin implementation.

Quick Start

Review the document located at /path/to/plan.md to identify areas for improvement.

Frequently Asked Questions about document-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I refine a brainstorming document for clarity and specificity?▼

Document refinement assesses your brainstorming text for clarity, completeness, and specificity. It identifies critical improvements and applies minor auto-fixes while seeking approval for substantive edits to ensure actionable plans.

What is the best way to identify scope creep in a project plan?▼

Identifying scope creep involves evaluating your project plan against YAGNI principles. This review process detects unstated assumptions and potential over-engineering, ensuring your document maintains focused and necessary requirements.

Can I automatically fix ambiguities in my planning documents?▼

Yes, refining planning documents includes auto-fixing minor issues like ambiguities automatically. For substantive edits that alter meaning or scope, the process seeks your explicit approval before applying any structural changes.

How do I review a plan document to ensure it is ready for implementation?▼

Reviewing a plan document for implementation readiness involves checking completeness, specificity, and adherence to YAGNI principles. The process pinpoints the single most impactful change needed and offers iterative next action suggestions.

Does the document review process support iterative refinement?▼

Yes, iterative refinement is supported by continuously assessing document clarity and completeness. After identifying and applying critical improvements, the process offers next action suggestions to guide subsequent editing cycles.

Related Skills

Explore More Content & Communication Skills→
GuitarAlchemistGuitarAlchemist

document-review

Review brainstorm or plan documents for clarity, completeness, and specificity.

Official
Intermediate
CommandCodeAICommandCodeAI
103

brainstorming

Convert vague ideas into structured design documents and implementation plans.

Official
Basic
mlopscommunitymlopscommunity
37

voice-first-planning

Convert spoken transcripts into structured feature specifications and requirements.

Official
Basic
yumechiyumechi

review-md

Check Markdown files for typos and textlint rule violations.

Community
Intermediate