Does this skill support MDX files?

Yes, it is specifically designed to create and edit documentation in Markdown and MDX formats common in modern developer portals.

Can I use this for existing documentation projects?

Absolutely. Use the skill to audit and rewrite existing docs to improve clarity, fix broken examples, and align them with a more modern, friendly tone.

Why does the skill avoid phrases like 'click here'?

It follows accessibility and SEO best practices by requiring descriptive link text that explains the destination, rather than generic directional language.

What is the Metabase style for documentation?

It emphasizes a conversational, clear, and user-focused tone, avoiding formal jargon like 'utilize' and preferring direct, person-to-person communication.

How does it handle documentation formatting?

The skill includes an automated formatting step using Prettier to ensure consistent spacing, indentation, and structure across all edited files.

Metabase-Style Documentation Writer

Name: Metabase-Style Documentation Writer
Author: Microck

byMicrock

•

152

•

学习与文档

Writes clear, conversational, and user-centric technical documentation following the Metabase style guide.

This skill empowers Claude to produce documentation that is both highly readable and practical, moving away from stiff, formal technical writing toward a conversational and accessible tone. It focuses on identifying audience needs, providing action-oriented headings, and maintaining consistency through standardized formatting. By utilizing the Metabase style guide, it ensures that technical guides, tutorials, and MDX files are professional yet approachable, helping users find answers quickly while ensuring code examples are verified and styles are consistent via Prettier integration.

主要功能

01Action-oriented heading generation for improved scannability

02Audience-matching to ensure technical depth meets reader expectations

03Consistent UI element bolding and code snippet backticking standards

04Automated documentation formatting via Prettier integration

05152 GitHub stars

06Conversational tone management based on the Metabase style guide

使用场景

01Refactoring dry, overly formal technical documentation into accessible user guides

02Standardizing documentation styles across a project using automated formatting tools

03Drafting new Markdown or MDX tutorials for software features

What are Skills?·How to Install

Install with 🐟 Skill.Fish

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

For use in Claude.ai and ChatGPT

主要功能

01Action-oriented heading generation for improved scannability

02Audience-matching to ensure technical depth meets reader expectations

03Consistent UI element bolding and code snippet backticking standards

04Automated documentation formatting via Prettier integration

05152 GitHub stars

06Conversational tone management based on the Metabase style guide

使用场景

01Refactoring dry, overly formal technical documentation into accessible user guides

02Standardizing documentation styles across a project using automated formatting tools

03Drafting new Markdown or MDX tutorials for software features

What are Skills?·How to Install

Install with 🐟 Skill.Fish

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

For use in Claude.ai and ChatGPT