docs-write

Format Markdown and MDX docs with Metabase style using Prettier.

Updated Jan 14, 2026
One-click install
npx skills add https://github.com/joshkellett87/useful-skills --skill docs-write-joshkellett87
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: docs-write
Source: https://github.com/joshkellett87/useful-skills/tree/main/docs-write
Command: npx skills add https://github.com/joshkellett87/useful-skills --skill docs-write-joshkellett87

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documentation writing is often inconsistent and hard to follow. This skill provides a clear, user-focused approach aligned with Metabase style to standardize doc creation and editing across Markdown, MDX, and related formats.

Core Features & Use Cases

  • Style guidance for Markdown, MDX, and related documentation formats.
  • Guidance on structure, headings, links, and examples to improve readability and maintainability.
  • Use Case: when creating or updating product documentation, onboarding guides, or API references, apply the style guidelines to ensure consistency and clarity.

Quick Start

Create or update a documentation file following the Metabase style guide, then run yarn prettier --write <file-path> to format it.

Frequently Asked Questions about docs-write

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I format Markdown documentation to ensure consistent typography and headings?▼

To format Markdown documentation consistently, you can apply a style guide to your draft and run a formatter like prettier. This standardizes typography, headings, links, and code formatting for user-focused docs.

What is the best way to write user-focused product documentation in MDX?▼

The best way to write user-focused product documentation in MDX is to apply a standardized style guide during creation and editing, followed by automated formatting to ensure clarity and structural consistency.

Does this approach work for onboarding guides and API references?▼

Yes, this approach works for onboarding guides and API references. Applying style guidelines to these documentation types ensures standard structure, readable examples, and consistent formatting across various product materials.

Do I need prettier to format MDX files with a style guide?▼

Yes, you need prettier to format MDX files with a style guide. Running prettier ensures consistent typography, headings, links, and code formatting across your documentation after applying the style guidelines.

Why standardize documentation formatting across Markdown files?▼

Standardizing documentation formatting across Markdown files prevents inconsistent and hard-to-follow docs. Applying a user-focused style guide improves readability, structure, and maintainability across all product documentation.