diff --git a/.gitignore b/.gitignore
index 88a966e..8ce29f8 100644
--- a/.gitignore
+++ b/.gitignore
@@ -4,3 +4,4 @@ server/data/
 .worktrees/
 server/.env
 *.db
+.claude/settings.local.json
diff --git a/CLAUDE.md b/CLAUDE.md
index 9995036..d540b6c 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -25,3 +25,12 @@ This is **Darkwatch**, a real-time session manager for the Shadowdark TTRPG.
 - Local git repo only — commits are fine, NEVER push
 - All imports use `.js` extensions (ES modules)
 - Dev seed accounts: `dm@darkwatch.test` / `player@darkwatch.test` (password: `password`)
+
+## Project Skills
+
+Project-local skills live in `.claude/skills/`. Invoke them by asking Claude to "use the [skill name] skill" or by reading the skill file directly.
+
+| Skill | File | When to use |
+|---|---|---|
+| `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 |