skills/smithery.ai/write-docs

write-docs

SKILL.md

Write Docs

Overview

Write clear, progressive documentation for this repository using the existing Starlight + MDX docs setup. Favor stepwise examples, explicit usefulness, and consistent tone.

Workflow

  1. Locate the target doc or create a new MDX file under www/src/content/docs/.
  2. Follow the style reference in references/docs-style.md.
  3. Start each feature or API section with: what it does, why it is useful, then an example.
  4. Build examples incrementally (naive first, then improvements and features).
  5. Use Starlight code line highlighting (ins, del, {n-m}) to emphasize changes while keeping full context.
  6. Keep guide content and API reference content clearly separated by headings or separate docs.

House style essentials

Installs
5
First Seen
Mar 19, 2026