Can this skill format my Markdown files?

Yes, the skill includes patterns for running Prettier to ensure consistent formatting and layout across your entire documentation suite.

Does it support modern documentation frameworks?

Absolutely. It is designed to work with standard Markdown and MDX files used in tools like Docusaurus, Nextra, and GitBook.

What is the Metabase style guide?

It is a set of principles that favors conversational, clear, and user-focused documentation over overly formal or academic technical writing.

How does this skill improve user experience?

It focuses on getting users to answers faster by using descriptive headings, removing 'peppy' or formal filler, and ensuring all code examples are functional.

Why does it avoid terms like 'utilize'?

The skill follows the philosophy of using simple, direct language (like 'use' instead of 'utilize') to keep documentation accessible to all levels of readers.

Documentation Writing Style

Name: Documentation Writing Style
Author: TerryTong-Git

byTerryTong-Git

0•

Content Management

Writes and edits user-focused documentation following a conversational style guide to ensure technical content is clear and accessible.

This skill enables Claude to author and refine documentation files (Markdown, MDX) by adhering to the Metabase style guide, which emphasizes a reader-first approach. It focuses on matching complexity to the target audience, using action-oriented headings, and maintaining a professional yet conversational tone. By prioritizing direct answers over dense explanations and enforcing consistent formatting via tools like Prettier, this skill helps developers create high-quality guides that users actually enjoy reading.

Key Features

010 GitHub stars

02Enforces American spelling, serial commas, and specific UI element bolding

03Implements action-oriented heading structures for better scannability

04Integrates with Prettier for automated documentation formatting

05Adheres to Metabase conversational style standards for technical writing

06Validates code examples and CLI command patterns for accuracy

Use Cases

01Editing existing documentation to remove formal jargon and improve clarity

02Transforming complex technical specifications into user-friendly how-to guides

03Standardizing a project's documentation voice and formatting across multiple MDX files

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add terrytong-git/astrabashcontrol-backup docs-write

For use in Claude.ai and ChatGPT

Download Skill