docs-write

Generate and edit Metabase documentation in Markdown and MDX formats.

48.6k|6.7k|Updated Feb 2, 2015
One-click install
npx skills add https://github.com/metabase/metabase --skill docs-write
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-write
Source: https://github.com/metabase/metabase/tree/main/.claude/skills/docs-write
Command: npx skills add https://github.com/metabase/metabase --skill docs-write

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Write clear, user-focused documentation for Metabase; ensure readability and correctness.

Core Features & Use Cases

  • Draft docs with a user-first approach
  • Edit for clarity and accuracy
  • Ensure consistent formatting, links, and terminology
  • Apply style guidance (bold UI elements, descriptive links)

Quick Start

Create a new doc detailing how to install Metabase; ensure steps are clear and well-structured.

Frequently Asked Questions about docs-write

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

FAQPage Schema
How do I write clear documentation in Markdown that follows a consistent style guide?

Write documentation by applying a user-first approach: use bold for UI elements, backticks for code and variables, descriptive links, American spelling with serial commas, and consistent heading structure. Run Prettier after editing to enforce formatting rules automatically.

What's the best way to structure step-by-step documentation for clarity?

Structure docs with clear headings, numbered steps, and descriptive language. Use bold for UI elements, backticks for code references, and ensure each step builds logically. Prettier formatting maintains consistency across the documentation set.

How do I ensure my Markdown documentation stays formatted consistently?

Use Prettier to automatically enforce consistent formatting after editing. It applies standardized spacing, indentation, and line breaks across Markdown and MDX files, reducing manual formatting overhead and ensuring uniform style compliance.

Can I apply documentation standards to both Markdown and MDX files?

Yes, this approach works with both Markdown and MDX formats. Apply the same style guide rules—bold UI elements, descriptive links, code backticks, American spelling—and run Prettier on both file types to maintain consistent formatting and terminology.

What formatting conventions should I follow for technical documentation?

Use backticks for code snippets and variable names, bold for UI element references, descriptive link text, American spelling with serial commas, and logical heading hierarchy. These conventions improve readability and ensure documentation adheres to style guide standards.

Why is enforcing consistent linking and style important in documentation?

Consistent linking and styling improve user navigation, reduce confusion, and establish credibility. Descriptive links help users understand destinations before clicking, while standardized formatting (bold UI elements, backticks for code) makes technical content scannable and accessible.