What documentation style does this skill use?

The skill follows the Metabase documentation style guide, which prioritizes a conversational, clear, and user-focused tone over formal technical language.

How does it handle complex technical jargon?

It actively simplifies language by replacing formal words like 'utilize' or 'reference' with simpler alternatives and avoiding overly technical descriptions when simple ones suffice.

Does it support UI-specific documentation?

Absolutely. It specifically enforces bolding for UI elements and backticks for code or variables to help users distinguish between interface actions and technical values.

Can it format my Markdown files automatically?

Yes, the skill includes a step to run Prettier on your documentation files to ensure consistent formatting and professional presentation.

Will it help with SEO in my documentation?

By enforcing descriptive link text (avoiding 'click here') and using clear, point-driven headings, it naturally improves the SEO and scannability of your docs.

Metabase Style Documentation Writer

Name: Metabase Style Documentation Writer
Author: Activer007

byActiver007

•

Learning & Documentation

Writes and edits documentation using a conversational, user-focused style inspired by Metabase's clear and approachable guidelines.

The docs-write skill transforms Claude into a specialized technical writer focused on clarity and accessibility. By following the Metabase style guide, this skill ensures that documentation is conversational rather than formal, replacing jargon like 'utilize' with 'use' and prioritizing actionable instructions over dense theory. It handles the entire writing lifecycle—from drafting with audience-specific complexity to polishing with descriptive links and bolded UI elements. Finally, it integrates with Prettier to ensure that all Markdown and MDX files meet strict formatting standards, making it an essential tool for maintaining high-quality, professional developer and user guides.

Key Features

01Action-oriented heading generation for better readability

026 GitHub stars

03Automated Markdown/MDX formatting via Prettier integration

04Smart styling for UI elements (bold) and code variables (backticks)

05Conversational tone enforcement using the Metabase style guide

06Audience-matching to balance complexity for different user levels

Use Cases

01Ensuring consistent formatting and link styles across large documentation sets

02Auditing existing documentation to remove passive voice and formal jargon

03Converting complex technical features into easy-to-read user tutorials

What are Skills?·How to Install

Install with 🐟 Skill.Fish

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

For use in Claude.ai and ChatGPT

Download Skill