skills.rest
Andreicr1
Andreicr1COMMUNITY
Explore all skills by this author →
GitHub

document-review

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

Updated Aug 23, 2026
Search Tags:#planning#editing#clarity#simplification#brainstorm#document-review
One-click install
npx skills add https://github.com/Andreicr1/Netz-Private-Credit-OS --skill document-review-andreicr1
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: document-review
Source: https://github.com/Andreicr1/Netz-Private-Credit-OS/tree/main/.github/skills/document-review
Command: npx skills add https://github.com/Andreicr1/Netz-Private-Credit-OS --skill document-review-andreicr1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a structured, repeatable review process to improve brainstorm or plan documents so they are clear, appropriately scoped, and ready for the next workflow step.

Core Features & Use Cases

  • Structured assessment: Walks the document against clarity, completeness, specificity, and YAGNI to surface issues without immediately changing intent.
  • Evaluation & prioritization: Scores key criteria and identifies a single critical improvement that will most increase document quality.
  • Safe edits and collaboration: Auto-fixes minor problems, requests approval for substantive edits, and updates documents inline per user consent.
  • Use case: Turn a rough team brainstorm into a focused plan with clear next actions and one prioritized change to unblock implementation.

Quick Start

Ask the document-review skill to read the latest file in docs/brainstorms or docs/plans and provide a prioritized review with one critical improvement and minor auto-fixes.

Frequently Asked Questions about document-review

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

FAQPage Schema
How do I review brainstorm documents for clarity and unnecessary scope before planning?▼

A structured document review evaluates brainstorms against clarity, completeness, specificity, and YAGNI criteria. It surfaces unnecessary scope and missing details without altering original intent, ensuring the planning document is ready for the next workflow step.

What is the best way to refine rough brainstorms into focused plans with clear next actions?▼

Refining rough brainstorms into focused plans requires a structured review that scores key criteria and identifies one critical improvement. This prioritization unblocks implementation by highlighting the most impactful change needed for actionable next steps.

Can I auto-fix minor document issues while keeping substantive changes manual?▼

Yes, safe document editing auto-fixes minor issues inline while requesting user approval for substantive changes. This approach automatically resolves small problems but requires consent before altering the document's core planning intent or scope.

How do I evaluate completeness and specificity in planning documents?▼

Evaluating completeness and specificity in planning documents involves walking the text through a structured assessment framework. This verifies necessary details are present and appropriately scoped, surfacing one critical improvement to maximize document quality.

Does document review work with files already stored in docs/brainstorms and docs/plans?▼

Document review directly accesses files stored in docs/brainstorms and docs/plans directories. It discovers and reads the latest text files in these locations to provide a prioritized review featuring inline auto-fixes and one critical improvement.

Related Skills

Explore More Product & Management Skills→
andrewhwallerandrewhwaller

document-review

Review brainstorm and plan documents for clarity, completeness, and YAGNI.

Community
Intermediate
shalevaminshalevamin

notion-spec-to-implementation

Convert Notion specification documents into implementation plans and tasks.

Community
Advanced
pko89403pko89403
1

idea-refine

Refine raw ideas into actionable concepts through structured phases.

Community
Intermediate
ShubhamsabooShubhamsaboo
131.7k

editor

Edit text for clarity, grammar, and readability across documents.

Community
Basic