🗺️ Technical Writing · Journey Playbooks

Playbook: Overhaul a neglected docs site

Sorted page types, working pipelines, and freshness signals readers trust again.

journey~80 minTechnical WritersDeveloper AdvocatesEngineers Who Document

Journey Steps

1Step 1 — Sort docs into types readers recognize: start with "Label every existing page: learning-journey, task-recipe, information-lookup, or theory"
2Step 2 — Run docs through the same pipeline as code: start with "Store docs beside code or in sibling repo with same review gates"
3Step 3 — Write changelogs users read: start with "Categorize: Added / Changed / Fixed / Breaking / Security only"
4How it fits together: Sort types before rewriting anything. Half the mess resolves itself once modes separate.

Commands

Install all referenced skills

$ npx skills add aniruddhaadak80/skills --skill docs-systems-diataxis-audit && npx skills add aniruddhaadak80/skills --skill docs-systems-docs-as-code-workflow && npx skills add aniruddhaadak80/skills --skill dev-content-changelog-users-read

Tags

#playbook#journey#technical-writing

Install this skill

$ npx skills add aniruddhaadak80/skills --skill playbook-technical-writing-docs-overhaul -a opencode

SKILL.md

# Playbook: Overhaul a neglected docs site

> Sorted page types, working pipelines, and freshness signals readers trust again.

## When to Use This Skill

Sorted page types, working pipelines, and freshness signals readers trust again.

## Steps

1. Step 1 — Sort docs into types readers recognize: start with "Label every existing page: learning-journey, task-recipe, information-lookup, or theory"
2. Step 2 — Run docs through the same pipeline as code: start with "Store docs beside code or in sibling repo with same review gates"
3. Step 3 — Write changelogs users read: start with "Categorize: Added / Changed / Fixed / Breaking / Security only"
4. How it fits together: Sort types before rewriting anything. Half the mess resolves itself once modes separate.

View source on GitHub ↗

Take retrieval-augmented answers from empty repo to evaluated production feature.

🗺️ AI Engineering·~135m

Open →

🗺️Playbook: Harden an agent before giving it toolsjourney

Ship an autonomous agent whose failure modes are cheap, visible, and reversible.

🗺️ AI Engineering·~125m

Open →

🗺️Playbook: Cut LLM costs without quality collapsejourney

Reduce monthly inference spend measurably while keeping answer quality within tolerance.

🗺️ AI Engineering·~95m

Open →