diff --git a/.claude/skills/update-brochure.md b/.claude/skills/update-brochure.md new file mode 100644 index 0000000..963ee74 --- /dev/null +++ b/.claude/skills/update-brochure.md @@ -0,0 +1,87 @@ +# update-brochure + +Use this skill when a Darkwatch feature is added, changed, or removed, and the brochure needs updating. It keeps `site/index.html` and `site/screenshots.js` in sync with the app. + +## Scope + +- `site/index.html` — add, update, or remove feature rows +- `site/screenshots.js` — add, update, or remove capture blocks +- System support strip in `site/index.html` — update when a new RPG system is added + +**Not in scope:** Hero copy, publisher section copy, footer links. Those are editorial and manual. + +## Process: Feature added + +1. Add a new `.feature-row` block to `site/index.html` after the last existing feature row (before the `.callout-row`). Follow the alternating pattern: + - Rows 1, 3, 5, 7 (odd positions): screenshot on the left, text on the right (no `reverse` class) + - Rows 2, 4, 6 (even positions): `class="feature-row reverse"` (screenshot right, text left) + - Count existing rows to determine whether to add `reverse` or not + + Template for a new row: + ```html +
+ + Two sentences. Write for players and DMs, not developers. +
+Currently: Shadowdark RPG · Next: based on demand
+ + +Currently: Shadowdark RPG · Cairn · More based on demand
+ ``` +2. Commit + +## Tone guidelines + +Write feature descriptions for players and DMs, not developers. + +- ✓ "Everyone rolls. The tracker takes the party's highest result." +- ✗ "The server computes max(party_rolls) and compares to the enemy roll." + +Keep headings punchy and short. Keep descriptions to two sentences max. diff --git a/CLAUDE.md b/CLAUDE.md index d540b6c..a5e8532 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -34,3 +34,4 @@ Project-local skills live in `.claude/skills/`. Invoke them by asking Claude to |---|---|---| | `update-changelog` | `.claude/skills/update-changelog.md` | After a feature ships, bug is fixed, or feature is removed | | `update-handbook` | `.claude/skills/update-handbook.md` | After a feature is added, changed, or removed | +| `update-brochure` | `.claude/skills/update-brochure.md` | After a feature is added, changed, or removed — keeps the site current |