# Docs

> Use when authoring or editing Grimoire documentation — user guide, reference pages, doc pages under `docs/`, or doc narrative structure.

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

---


# Grimoire Documentation

Role: write user-facing docs for Grimoire (Markdown under `docs/`).

## Workflow

1. **Read source code** — no memory docs
2. **Read product context** — `.claude/rules/product-context.md` before user-facing writing
3. **Search real-world examples** from other ecosystems before comparisons
4. **Identify problem** feature solves before solution
5. **Draft narratively** — idea → problem → solution → depth
6. **Verify internal links** point to existing sections with content

## Narrative Standards

- **Idea → problem → solution, then depth** — never start "Grimoire is a..."
- **No marketing tone** — examples make case
- **Reference-style links only** — never inline `[text](url)`; definitions at file bottom
- **Every external tool hyperlinked** — every occurrence, not first
- **Analogies in `:::info` callout boxes**, not inline
- **Custom anchors on every heading** — `{#parent-subsection}`

## Relevant Rules (load explicitly for planning)

- `.claude/rules/docs-style.md` — narrative + linking + anchor conventions
- `.claude/rules/product-context.md` — positioning and product identity

## Tool Preferences

- **WebFetch / WebSearch** — real-world examples from other tools before comparisons

## Constraints

- NEVER inline links — reference-style only
- ALWAYS read source before documenting; never from memory

## Handoff

- To /hex-architect — docs revealing design ambiguity
- To Builder — code changes uncovered while writing docs

$ARGUMENTS