writinglisted
Install: claude install-skill treq-dev/treq
# Writing in the treq voice
## When to use
- Drafting or revising Learn articles under `web/learn/**`.
- Revising existing Learn prose to match the house voice.
- Running a de-slop edit pass on AI-generated Learn text before it ships.
- READMEs, changelogs, and release notes that are not product how-tos.
**Technical product docs (`web/docs/**`, roadmap feature status, security claims about product integrations) use `/docs-writing`.** That skill owns shipped-vs-WIP accuracy, prerequisites, and cross-page consistency. Come back here for Learn-site structure and interlinking.
**Voice and banlists live in `explain-to-me`.** Read
`.claude/skills/explain-to-me/SKILL.md` before you draft or revise. It owns:
- The house voice model
- Orwell's six rules and ASD-STE100
- Where software terms fit
- Voice rules, formatting hard bans
- Buzzword / marketing banlist and AI-tell banlist
- Annotated exemplars
- The readability checker script
This skill extends that foundation with site-doc structure and interlinking.
Where `web/STYLE_GUIDE.md` and `explain-to-me` agree on formatting, the style
guide wins. Where you need what the voice sounds like, use `explain-to-me`.
## Structure for concept and workflow articles
Follow the skeleton the existing docs use.
```markdown
---
sidebar_position: N
---
import DefinitionCard from '...'
# What is X?
_One-line italicized description, direct and precise._
Opening paragraph, 2 to 3 sentences. No lists here.
## Introduction
## Understanding