Does this skill help with file formatting?

Yes, it specifically includes instructions to run Prettier on documentation files to ensure consistent formatting across the project.

How does it handle code examples?

It ensures code examples are practical, verified, and correctly formatted with backticks, prioritizing functional instructions over buried explanations.

Can I use this for non-Metabase projects?

While optimized for the Metabase style, its principles of clarity, action-oriented headings, and user-focus are beneficial for any technical documentation project.

What tone does this skill use for documentation?

This skill follows the Metabase style guide, which is conversational, clear, and focused on getting the user to their answer quickly without unnecessary formality.

Which file formats are supported?

The skill is designed to work with markdown (.md), MDX (.mdx), and other text-based documentation formats.

Metabase Style Documentation Writer

Name: Metabase Style Documentation Writer
Author: GregBaron

byGregBaron

Content Management

Writes and edits clear, conversational technical documentation following the Metabase style guide for markdown and MDX files.

About

The docs-write skill enables Claude to produce high-quality, user-centric documentation that adheres to Metabase's specific conversational tone and structural standards. It focuses on matching complexity to the audience, using action-oriented headings, and maintaining a professional yet accessible voice. The skill also handles technical formatting tasks, such as enforcing American spelling, descriptive linking, and running Prettier to ensure consistent code styling across the entire documentation suite.

Key Features

Ensures consistent American spelling and serial comma usage
Filters out formal jargon and overly complex technical language
Standardizes markdown and MDX formatting using Prettier
0 GitHub stars
Generates action-oriented headings and descriptive link text
Enforces a conversational, clear, and user-focused writing style

Use Cases

Drafting new feature guides or technical tutorials for Metabase-based projects
Auditing and refactoring existing documentation to align with professional style guides
Automatically formatting and polishing markdown files for consistent presentation

About

Key Features

Ensures consistent American spelling and serial comma usage
Filters out formal jargon and overly complex technical language
Standardizes markdown and MDX formatting using Prettier
0 GitHub stars
Generates action-oriented headings and descriptive link text
Enforces a conversational, clear, and user-focused writing style

Use Cases

Drafting new feature guides or technical tutorials for Metabase-based projects
Auditing and refactoring existing documentation to align with professional style guides
Automatically formatting and polishing markdown files for consistent presentation