# Docs Verify Compliance

> Fix compliance issues in a documentation file against writing style and mdoc conventions.

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

---


# Verify Documentation Compliance

## Workflow

Run these commands in order:

```bash
/docs-check-compliance $ARGUMENTS docs-writing-style
/docs-check-compliance $ARGUMENTS docs-mdoc-conventions
sbt "docs/mdoc --in $ARGUMENTS --out website/$ARGUMENTS"
```

Never bare `sbt docs/mdoc` without `--in`/`--out` — it recompiles every doc in the tree instead of just
this one. `--out` is `$ARGUMENTS` prefixed with `website/`, matching where mdoc's output belongs.

Fix all violations identified by `/docs-check-compliance`, committing each separately. Ensure the final mdoc compilation succeeds with zero errors.