Does it provide suggestions for fixes?

Yes, every identified issue includes a succinct description of the problem along with a suggested fix or explanation for the author.

How does the docs-review skill handle PRs?

It uses a pending review workflow to identify all issues first, then posts them as a single, cohesive set of comments on the GitHub Pull Request.

Can I use this for non-Metabase projects?

While it is optimized for the Metabase style guide, its logic and formatting serve as an excellent framework for any documentation review task.

What tools does this skill utilize?

The skill uses Read, Grep, Bash, and Glob tools to scan files and analyze diffs within your repository.

What style rules does this skill enforce?

It checks for conversational tone, descriptive link text, proper structure, and the removal of condescending language like 'simple' or 'just'.

Metabase Documentation Reviewer

Name: Metabase Documentation Reviewer
Author: metabase

bymetabase

•

45,683

•

コンテンツ管理

Reviews markdown documentation for style guide compliance, tone consistency, and technical clarity.

The Metabase Documentation Reviewer is a specialized skill designed to audit documentation changes against a specific writing style guide. It streamlines the peer-review process by identifying issues like corporate jargon, vague headings, and inconsistent formatting in markdown files. Whether running locally or directly within a GitHub Pull Request, the skill provides structured, numbered feedback that helps technical writers and developers maintain high-quality, accessible, and user-centric documentation.

主な機能

01Validation of code examples, links, and command execution order

02Dual-mode support for local conversations and GitHub PR reviews

03Sequential issue numbering for easy referencing and tracking

04Automated compliance checks against the Metabase style guide

0545,683 GitHub stars

06Analysis of tone, voice, and instructional clarity

ユースケース

01Standardizing technical terminology across large open-source repositories

02Refining instructional content to remove condescending or overly formal language

03Automating documentation audits during the PR review process

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add metabase/metabase docs-review

For use in Claude.ai and ChatGPT

Download Skill