Can I use this skill to write documentation from scratch?

This skill is optimized for reviewing existing drafts. For initial drafting, it is recommended to use the writing-functional-docs or writing-api-docs skills.

Does it support API documentation specifically?

Yes, it includes specialized checklists for API docs, covering HTTP methods, parameters, field descriptions, and JSON example validity.

Why does it flag passive voice?

Active voice is a best practice in technical writing because it is more direct, easier to understand, and simplifies translation for global audiences.

What documentation dimensions does this skill evaluate?

It evaluates five key dimensions: Voice and Tone, Structure, Completeness, Clarity, and Technical Accuracy.

What kind of output does the review provide?

The skill provides a Review Summary with a verdict (PASS, NEEDS_REVISION, or MAJOR_ISSUES), a prioritized list of issues, and specific recommendations.

Technical Documentation Review

Name: Technical Documentation Review
Author: LerianStudio

byLerianStudio

•

Learning & Documentation

Audits and improves technical documentation by enforcing standards for voice, structure, completeness, and technical accuracy.

The documentation-review skill provides a systematic framework for evaluating and refining technical content before publication. It enforces high-quality standards by checking for active voice, proper hierarchical structure, and technical correctness in API references and how-to guides. By identifying issues like passive voice, excessive sentence length, and missing examples, it ensures that your documentation remains clear, scannable, and developer-friendly, ultimately reducing user friction and improving the developer experience.

Key Features

0117 GitHub stars

02Voice and tone auditing for active voice and present tense consistency

03Technical accuracy validation for code snippets and API paths

04Structural analysis of heading hierarchy and section organization

05Completeness verification for conceptual guides and API references

06Readability checks targeting sentence length and jargon reduction

Use Cases

01Reviewing AI-generated drafts for technical accuracy and structural clarity

02Auditing existing documentation folders to ensure compliance with style guides

03Performing a final quality gate check before publishing new feature documentation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lerianstudio/ring documentation-review

For use in Claude.ai and ChatGPT

Download Skill