Can I use this for GitHub Pull Requests?

Yes, it includes a dedicated PR review mode that uses GitHub MCP tools to post sequentially numbered comments directly onto the pull request diff.

What kind of writing issues does it detect?

It flags corporate jargon (like 'utilize'), vague headings, incorrect backtick usage on UI elements, non-descriptive link text, and non-functional code examples.

What style guide does this skill follow?

This skill is primarily configured to follow the Metabase writing style guide, focusing on conversational tone, specific UI element formatting, and readability.

Does it automatically fix the issues it finds?

It provides specific suggestions and explanations for each issue found, allowing the author to review and apply the fixes accurately.

Does it work with local files?

Absolutely. If the GitHub review tool is not available, it defaults to a local mode that outputs a numbered markdown list of issues in the conversation.

Documentation Style Reviewer

Name: Documentation Style Reviewer
Author: Microck

byMicrock

•

108

•

콘텐츠 관리

Reviews documentation changes for compliance with style guides and readability standards across markdown files and pull requests.

The Documentation Style Reviewer skill automates the auditing of markdown files and pull requests to ensure they adhere to professional writing standards, specifically optimized for the Metabase style guide. It analyzes tone, structure, formatting, and link quality to eliminate 'corporate-speak' and improve clarity. By detecting whether it's operating in a local environment or a GitHub PR, it provides structured, sequentially numbered feedback that helps maintain a consistent voice and high-quality documentation without manual overhead.

주요 기능

01Automated style guide compliance checking for tone and voice

02Validation of UI element formatting, link descriptions, and code examples

03Parallel comment posting for efficient GitHub pull request workflows

04Sequential issue numbering for easy reference and tracking

05108 GitHub stars

06Dual-mode detection for local terminal output or GitHub PR reviews

사용 사례

01Enforcing standardized UI element bolding and link descriptive text across a project

02Auditing local markdown files for readability and corporate jargon before committing

03Reviewing documentation PRs to ensure consistent terminology and formatting

What are Skills?·How to Install

Install with 🐟 Skill.Fish

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

For use in Claude.ai and ChatGPT

Download Skill