# Mdk Docs Style

> Router for MDK docs-authoring rules.

- Skill: `tetherto/mdk-docs-style` (Agent Skill)
- Install (CLI): `npx skillmds@latest add tetherto/mdk-docs-style`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tetherto/mdk-docs-style/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tetherto (https://skillmd.com/u/tetherto)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tetherto/mdk-docs-style

---


# MDK docs style guide (router)

The rules live in [`docs/reference/maintainers/style.md`](../../docs/reference/maintainers/style.md). Read it before authoring or editing:

- `docs/**/*.md` (the root docs tree)
- Any `README.md`
- Any `backend/**/docs/**/*.md` or `ui/**/docs/**/*.md` 

Don't store style rules here.

## Read in addition, by task

- Adding or editing a reference-style link definition (`[slug]: …`), or an admonition on a page that might be ported to `tether.io`: [single-source-of-truth.md](../../docs/reference/maintainers/single-source-of-truth.md), the routing-comment vocabulary the port pipeline reads
- Editing `AGENT_READY.md` or `USAGE.md` in a package's `docs/`: [`style.md`](../../docs/reference/maintainers/style.md) governs the prose, but [`agent-ready-sdk.md`](../../docs/reference/maintainers/agent-ready-sdk.md) governs the required contract structure; read both
- Editing a `README.md` with a marked generated region (for example [`backend/core/plugins/README.md`](../../backend/core/plugins/README.md)'s `<!-- BEGIN GENERATED: … -->` / `<!-- END GENERATED -->` block): never hand-edit inside the markers; regenerate with the documented script instead (that file: `npm run generate:plugin-reference` in [`backend/core/plugins`](../../backend/core/plugins/README.md))

## Note on existing content

Existing READMEs and package docs predate this scope apply [`style.md`](../../docs/reference/maintainers/style.md) going forward on pages you touch; don't mass-rewrite existing files unprompted.

## Hard constraints

- Don't touch historical files e.g. [`CHANGELOG.md`](../../CHANGELOG.md), release notes, or `package.json`, `node_modules`, or lock files without explicit approval
- "Hands off by default" is not "exempt from style". When you *do* edit [`CHANGELOG.md`](../../CHANGELOG.md) or release notes with approval (e.g. cutting a release via the `changelog` skill), [`style.md`](../../docs/reference/maintainers/style.md)'s prose rules still apply — including the 150–180 char line length (tables and fenced code exempt)