technical-doc-review

Identify style and structural issues in HiveMQ Edge Markdown documentation.

164|44|Updated Jun 30, 2023
One-click install
npx skills add https://github.com/hivemq/hivemq-edge --skill technical-doc-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: technical-doc-review
Source: https://github.com/hivemq/hivemq-edge/tree/main/hivemq-edge-frontend/.claude/skills/technical-doc-review
Command: npx skills add https://github.com/hivemq/hivemq-edge --skill technical-doc-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Technical Documentation Reviewer identifies style, structure, and terminology issues in HiveMQ Edge technical documentation by applying HiveMQ's writing guidelines, producing a structured, actionable report per file.

Core Features & Use Cases

  • Applies HiveMQ's Technical Documentation Writing Guidelines (v1.0) to Markdown files to surface passive voice, modal verbs, pronoun clarity, inconsistent terminology, and frontmatter gaps.
  • Generates a prioritized, per-file findings report grouped by severity and category, with actionable remediation suggestions.
  • Supports scanning the docs directory by default (docs/) or specific files and folders to meet common documentation QA needs.

Quick Start

Pass the path to the target Markdown documents (defaulting to docs/) and run the skill to generate a structured findings report.

Frequently Asked Questions about technical-doc-review

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

FAQPage Schema
How do I check markdown documentation for passive voice and terminology inconsistencies?

Technical documentation QA tools scan markdown files to identify passive voice, modal verbs, and inconsistent terminology, producing a prioritized report with severity groupings and actionable remediation suggestions per file.

How do I validate frontmatter consistency across a directory of markdown files?

To validate frontmatter consistency across markdown files, a style review tool scans the target directory, checks frontmatter fields against required specifications, flags gaps, and outputs a structured findings report grouped by severity.

What is the best way to automate quality assurance for technical documentation?

The best way to automate technical documentation quality assurance is applying structured writing guidelines across markdown directories to detect passive voice, terminology inconsistencies, and frontmatter gaps, generating a prioritized remediation report.

Can I run a style review on specific markdown files instead of an entire docs directory?

Yes, you can run a style review on specific markdown files by passing individual file paths or targeted folders instead of using the default docs directory, generating the same structured findings report for the selected scope.

What Tier 1 writing issues should I look for during a documentation style review?

During a documentation style review, you should look for Tier 1 writing issues including passive voice, modal verbs, and pronoun clarity problems, all of which are flagged with actionable remediation suggestions to improve content quality.

Why does my technical documentation QA report flag modal verbs and passive voice as issues?

Technical documentation QA reports flag modal verbs and passive voice as Tier 1 issues because active voice and direct language improve clarity, and identifying these issues with actionable suggestions ensures documentation meets strict style guidelines.