Can I use this for GitHub Pull Requests?

Yes, it includes a PR review mode that uses GitHub MCP tools to create pending reviews and post sequentially numbered comments directly to the diff.

Does it provide suggestions for improvement?

Yes, every flagged issue includes a succinct description of the problem and a suggested fix or explanation to help the author address the feedback quickly.

What kind of formatting errors does it detect?

It checks for common markdown mistakes such as using backticks for UI elements (which should be bold), non-descriptive link text like 'click here', and inconsistent list formatting.

Which style guide does this skill follow?

This skill is specifically configured to follow the Metabase writing style guide, which emphasizes clear, conversational, and user-centric technical documentation.

Documentation Style Reviewer

Name: Documentation Style Reviewer
Author: Activer007

byActiver007

Learning & Documentation

Audits documentation markdown files against the Metabase writing style guide for consistency and clarity.

About

The Documentation Style Reviewer is a specialized skill for Claude Code designed to enforce high-quality technical writing standards. It analyzes markdown files and diffs against the Metabase style guide, focusing on tone, voice, structural clarity, and precise formatting. The skill intelligently operates in two modes: a Local Review mode for immediate conversation feedback and a PR Review mode that integrates directly with GitHub to post structured, sequentially numbered comments. By flagging issues like corporate jargon, improper UI element formatting, and non-descriptive links, it ensures your documentation remains accessible, professional, and consistent.

Key Features

Tone and voice auditing to eliminate jargon and 'easy' qualifiers
Automated Metabase style guide enforcement
0 GitHub stars
Dual-mode support for GitHub PRs and local CLI feedback
Technical formatting validation for UI elements and code blocks
Sequential issue numbering for easy reference and tracking

Use Cases

Auditing technical guides for tone, clarity, and accessibility
Reviewing documentation pull requests for style guide compliance
Automating consistency checks across large markdown documentation repositories

About

Key Features

Tone and voice auditing to eliminate jargon and 'easy' qualifiers
Automated Metabase style guide enforcement
0 GitHub stars
Dual-mode support for GitHub PRs and local CLI feedback
Technical formatting validation for UI elements and code blocks
Sequential issue numbering for easy reference and tracking

Use Cases

Auditing technical guides for tone, clarity, and accessibility
Reviewing documentation pull requests for style guide compliance
Automating consistency checks across large markdown documentation repositories