docs-write

Apply Metabase style guidelines to draft and edit Markdown and MDX documentation.

105|12|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/tmcfarlane/oh-my-cursor --skill docs-write-tmcfarlane
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-write
Source: https://github.com/tmcfarlane/oh-my-cursor/tree/main/skills/docs-write
Command: npx skills add https://github.com/tmcfarlane/oh-my-cursor --skill docs-write-tmcfarlane

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documentation teams often struggle to produce consistent, reader-friendly material that adheres to Metabase's style guidelines. This skill provides a structured writing framework and a direct reference to the Metabase style guide to help writers achieve clarity and consistency across Markdown and MDX docs.

Core Features & Use Cases

  • Structured writing framework aligned with Metabase style guidelines
  • Guidance for tone, structure, and formatting in Markdown/MDX docs
  • Reference to the external style guide file and practical editing prompts

Quick Start

Open a Markdown documentation file and apply the Metabase writing guidelines to improve clarity.

Frequently Asked Questions about docs-write

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

FAQPage Schema
How do I write Metabase-style documentation in Markdown?

To write Metabase-style documentation in Markdown, apply a structured writing framework that enforces standardized frontmatter, tone, structure, and formatting rules. This ensures consistency and clarity across Markdown and MDX docs.

What is the best way to enforce a style guide across existing Markdown files?

Enforcing a style guide across existing Markdown files involves applying structured editing prompts that check tone, structure, and formatting. This process references an external style guide file to standardize documentation quality.

Can I use this framework to edit MDX knowledge base content?

Yes, you can edit MDX knowledge base content using this framework. It provides guidance for drafting and editing materials across both Markdown and MDX formats, ensuring adherence to Metabase style guidelines.

Does documentation editing require standardized frontmatter usage?

Standardized frontmatter usage is required for documentation editing. The writing framework enforces standardized frontmatter to maintain consistency and adhere to Metabase style and formatting rules.

Why does my documentation lack consistency across knowledge base articles?

Documentation lacks consistency when writers do not follow a structured framework or reference a style guide. Applying standardized tone, structure, and formatting rules resolves inconsistencies across Markdown docs.

Are there limitations when applying a structured writing framework to external style guides?

Limitations depend on the external style guide file referenced. The framework enforces style and formatting rules, so customization or overrides beyond the Metabase style guidelines may require manual adjustments.