document-review

Assess brainstorm and plan documents for clarity, completeness, and specificity.

1|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/JimmyChen-NXP/zephyr-team-activity-dashboard --skill document-review-jimmychen-nxp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: document-review
Source: https://github.com/JimmyChen-NXP/zephyr-team-activity-dashboard/tree/main/.github/skills/document-review
Command: npx skills add https://github.com/JimmyChen-NXP/zephyr-team-activity-dashboard --skill document-review-jimmychen-nxp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps improve brainstorm or plan documents by identifying unclear sections, unnecessary content, and unstated assumptions, ensuring documents are ready for the next workflow step.

Core Features & Use Cases

  • Structured Document Assessment: Evaluates documents based on clarity, completeness, specificity, and adherence to YAGNI principles.
  • Critical Improvement Identification: Pinpoints the single most impactful change needed for a document.
  • Inline Editing: Makes minor auto-fixes and seeks approval for substantive changes, updating the document directly.
  • Use Case: After a team brainstorm session, use this skill to review the generated document, identify areas that are vague or could be misinterpreted, and refine it for clarity before moving to the planning phase.

Quick Start

Use the document-review skill to refine the brainstorm document located at docs/brainstorms/new-feature-ideas.md.

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 brainstorm document to ensure it is ready for planning?

Refine a brainstorm document by assessing its clarity, completeness, and specificity, then apply inline changes to simplify content without over-engineering. This identifies critical improvements and ensures the document is ready for the next workflow stage.

What is the best way to identify unstated assumptions in a plan document?

Identify unstated assumptions in a plan document through a structured assessment that evaluates clarity, completeness, and adherence to YAGNI principles. This process pinpoints the single most impactful change needed to remove vague or unnecessary content.

How do I edit brainstorm documents inline without losing the original context?

Edit brainstorm documents inline by applying minor auto-fixes directly and seeking approval for substantive changes. This iterative improvement method updates the document safely while maintaining the original context and simplifying the content.

Can I use automated document review for team collaboration brainstorms?

Automated document review supports team collaboration brainstorms by evaluating the generated document for clarity and specificity. It identifies areas that could be misinterpreted and refines the content before moving to the subsequent planning phase.

When should I not use inline editing for brainstorm refinement?

Inline editing for brainstorm refinement should not be used when substantive changes are required without seeking approval. The process prioritizes simplification and avoids over-engineering, making it unsuitable for heavily complex document restructuring.

Does document review apply the YAGNI principle to plan documents?

Document review applies the YAGNI principle to plan documents by assessing completeness and identifying unnecessary content. This ensures the document adheres to simplicity and avoids over-engineering before progressing to the next workflow step.