diff --git a/CLAUDE.md b/CLAUDE.md
index 6efe82a..c8740ce 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -64,3 +64,4 @@ docker build -t paper-dynasty-db .                          # Build image
 - Teams have dynamic card pricing based on market activity
 - Supports both human players and AI teams
 - Gauntlet events use special reward structures and card pools
+- Companion skill scripts (`~/.claude/skills/paper-dynasty/scripts/`) use the API, never direct DB access