Does it require a specific document format?

The skill works best with Markdown-based documentation and uses a classification step to determine the document type before applying the review protocol.

What document types does this skill support?

It is specifically optimized for reviewing brainstorms, project plans, and Product Requirement Documents (PRDs).

Can I use this for source code reviews?

No, this skill is designed for the planning and documentation phase. For reviewing implementation code, you should use specialized code-review skills.

What are the assessment criteria used?

Documents are scored on a 1-5 scale across five areas: Clarity, Completeness, Specificity, YAGNI (You Ain't Gonna Need It), and User Intent Fidelity.

How does the auto-fix feature work?

It identifies vague phrases and qualifiers—such as 'should handle' or 'appropriately'—and suggests or applies specific technical replacements to improve specificity.

Document Refinement

Name: Document Refinement
Author: majesticlabs-dev

bymajesticlabs-dev

•

Content Management

Analyzes and improves technical documentation, PRDs, and project plans to ensure clarity and readiness for development.

Document Refinement is a specialized skill for Claude Code designed to bridge the gap between initial ideation and technical execution. It performs a structured audit of brainstorms, plans, and Product Requirement Documents (PRDs), scoring them against critical criteria like specificity, completeness, and YAGNI (You Ain't Gonna Need It) principles. By automatically fixing vague language and flagging substantive gaps, this skill ensures that project documentation is actionable and aligned with user intent before engineers begin implementation, reducing downstream rework and scope creep.

Key Features

01Detailed readiness reports with actionable blocking issues

0229 GitHub stars

03Automated detection and fixing of vague language patterns

04Customizable review protocols for brainstorms, plans, and PRDs

05Structured scoring for clarity, completeness, and specificity

06YAGNI violation checks to prevent gold-plating and scope creep

Use Cases

01Validating project plans for vague phrasing that could lead to implementation errors

02Auditing brainstorming outputs for speculative features before handoff

03Reviewing a draft PRD to ensure all technical boundaries and behaviors are defined

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add majesticlabs-dev/majestic-marketplace document-refinement

For use in Claude.ai and ChatGPT

Download Skill