document-review

Review documents for gaps, clarity, completeness, and organization.

1|Updated Oct 17, 2025
One-click install
npx skills add https://github.com/softwaresalt/csv-managed --skill document-review-softwaresalt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: document-review
Source: https://github.com/softwaresalt/csv-managed/tree/main/.github/skills/document-review
Command: npx skills add https://github.com/softwaresalt/csv-managed --skill document-review-softwaresalt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you improve the clarity, completeness, and organization of a document before the next workflow step by identifying gaps, avoided decisions, hidden assumptions, and risks.

Core Features & Use Cases

  • Structural gap detection: Surfaces unclear parts, unnecessary content, avoided decisions, and unstated assumptions without rewriting prematurely.
  • Review lenses: Applies targeted checks (Product, Design, Security, Scope guardrails, and Adversarial) based on signals found in the document.
  • Quality scoring & next-step readiness: Evaluates clarity, completeness, specificity, and YAGNI, then identifies the single most critical improvement.
  • Minimal, safe editing workflow: Auto-fixes minor issues while asking approval for substantive changes, keeping edits inline and minimal.

Quick Start

Use the document-review skill to review the most recent plan in docs/plans and return a prioritized set of improvements.

Frequently Asked Questions about document-review

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

FAQPage Schema
How do I review a spec for gaps and hidden assumptions before moving to the next workflow step?

Structured document review applies active lenses to find gaps and unstated assumptions, scoring the plan against quality criteria. It identifies the single most critical improvement and makes minimal inline edits, gating substantive changes for approval.

What is the best way to check if a product plan is ready for development?

Quality scoring evaluates product plans for clarity, completeness, specificity, and YAGNI to determine next-step readiness. The review checks for avoided decisions and scope creep, highlighting exactly what must be fixed before proceeding.

Can I apply a security review lens to my architecture decision records?

Yes, document review applies targeted checks including Product, Design, Security, Scope guardrails, and Adversarial lenses based on signals found in the document. These active review lenses surface risks and security gaps specific to your ADRs.

How do I control scope creep when reviewing project specs?

Scope guardrails evaluate specs against YAGNI to identify unnecessary content and prevent scope creep. The structured review surfaces avoided decisions and unstated assumptions, scoring specificity to ensure the spec remains tightly bounded.

Does the document review process automatically rewrite my brainstorming notes?

No, the review avoids premature rewriting by auto-fixing only minor issues and asking approval for substantive changes. It keeps edits inline and minimal, preserving your original brainstorming content while prioritizing structural improvements.

When do I need a structured document review for my plans?

You need a structured document review when preparing brainstorms, plans, specs, or ADRs for the next workflow step. It improves clarity and organization by identifying gaps, avoided decisions, and unstated risks before you commit to development.