diff --git a/CLAUDE.md b/CLAUDE.md
index 984844902..e41fe5fc6 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1,5 +1,18 @@
 # gstack development
 
+## gstack skills
+
+Use the `/browse` skill for all web browsing. NEVER use `mcp__claude-in-chrome__*`
+tools (see the detailed "Browser interaction" section below for why).
+
+Available skills: /office-hours, /plan-ceo-review, /plan-eng-review,
+/plan-design-review, /design-consultation, /design-shotgun, /design-html,
+/review, /ship, /land-and-deploy, /canary, /benchmark, /browse, /connect-chrome,
+/qa, /qa-only, /design-review, /setup-browser-cookies, /setup-deploy,
+/setup-gbrain, /retro, /investigate, /document-release, /document-generate,
+/codex, /cso, /autoplan, /plan-devex-review, /devex-review, /careful, /freeze,
+/guard, /unfreeze, /gstack-upgrade, /learn.
+
 ## Commands
 
 ```bash