documentation-reviewer

Review documentation for clarity, consistency, and maintainability across formats.

13|13|Updated Aug 20, 2020
One-click install
npx skills add https://github.com/stackabletech/documentation --skill documentation-reviewer-stackabletech
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: documentation-reviewer
Source: https://github.com/stackabletech/documentation/tree/main/.agents/skills/documentation-reviewer
Command: npx skills add https://github.com/stackabletech/documentation --skill documentation-reviewer-stackabletech

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the need for clear, consistent, and maintainable documentation by providing expert review and feedback on various written content.

Core Features & Use Cases

  • Comprehensive Review: Analyzes formatting, terminology, links, language, flow, and evergreen principles.
  • Audience-Centric Feedback: Tailors suggestions based on the identified target audience.
  • Semantic Accuracy: Ensures content accurately reflects changes, especially in release notes and changelogs.
  • Use Case: Submit your draft user guide for a new software feature to get detailed feedback on clarity, consistency, and adherence to best practices before publication.

Quick Start

Use the documentation-reviewer skill to review the attached file 'api-guide.md'.

Frequently Asked Questions about documentation-reviewer

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

FAQPage Schema
How do I review technical documentation for clarity and consistency before publishing?

To review technical documentation effectively, analyze formatting, terminology, link quality, and language flow to ensure maintainability. This process evaluates READMEs, API docs, and user guides against a structured framework, yielding audience-centric feedback that improves semantic accuracy and overall content quality.

What is the best way to check release notes for semantic accuracy and audience appropriateness?

Checking release notes for semantic accuracy involves verifying that content accurately reflects software changes while tailoring language to the target audience. This review ensures changelogs adhere to evergreen principles, maintaining clarity and consistency across all published technical documentation.

Can I use an automated review framework to improve API docs and user guides?

You can use an automated review framework to evaluate API docs and user guides by checking formatting, terminology, and link quality. This approach provides structured, actionable feedback on language flow and audience appropriateness, ensuring technical writing remains maintainable.

Does documentation review work for maintaining evergreen content across different formats?

Documentation review works for maintaining evergreen content by systematically evaluating READMEs, API docs, and user guides. It focuses on evergreen principles, semantic accuracy, and consistency, ensuring your technical writing remains relevant, accurate, and highly maintainable over time.

How do I fix terminology and link quality issues in my technical writing?

Fixing terminology and link quality issues requires a comprehensive documentation review that identifies inconsistencies and broken references. By applying a structured review framework, you receive targeted feedback to standardize language, improve flow, and enhance overall content quality.

What are the limitations of using a structured framework for documentation editing?

A limitation of using a structured framework for documentation editing is that it requires strict adherence to a specific output format and review process. This means users must provide complete drafts and context to receive accurate, audience-centric semantic feedback.