What specific formatting rules does it enforce?

It checks for bolding on UI elements, descriptive link text, appropriate use of backticks, and avoids the use of ampersands or corporate jargon.

Can I use this for local files without GitHub?

Yes, it features a Local Review mode that outputs a numbered list of issues directly in your terminal or chat conversation.

What is the Documentation Review skill?

It is a specialized capability for Claude Code that reviews Markdown files to ensure they meet professional writing standards, specifically the Metabase writing style guide.

How does it handle GitHub Pull Requests?

If the GitHub MCP tool is available, the skill uses a pending review workflow to post all identified issues as separate, sequentially numbered comments on the PR diff.

Why does it number every issue found?

Sequential numbering is mandatory for this skill so that users can efficiently reference and track specific feedback items, such as 'fix issues 2 and 4'.

Documentation Reviewer

Name: Documentation Reviewer
Author: Activer007

byActiver007

0•

콘텐츠 관리

Reviews documentation changes for compliance with the Metabase writing style guide across PRs and local files.

The Documentation Reviewer skill automates the auditing of Markdown files against the Metabase writing style guide. It functions in two modes: a local review mode for immediate conversation-based feedback and a structured GitHub PR mode that posts sequentially numbered comments directly to code changes. By analyzing tone, structure, formatting, and technical accuracy, it ensures documentation remains clear, professional, and accessible while avoiding common pitfalls like corporate jargon, improper UI element formatting, and non-descriptive links.

주요 기능

01Tone and voice analysis to maintain professional accessibility

02Automated Metabase style guide compliance auditing

030 GitHub stars

04GitHub PR integration with parallel threaded review comments

05Sequential issue numbering for efficient feedback tracking

06Local CLI-based feedback for rapid documentation drafting

사용 사례

01Pre-commit checking of local Markdown files to ensure readability

02Refining technical tutorials to remove condescending qualifiers like 'easy' or 'simple'

03Auditing GitHub Pull Requests for documentation style consistency

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add activer007/ordinary-claude-skills docs-review

For use in Claude.ai and ChatGPT

Download Skill