diff --git a/CLAUDE.md b/CLAUDE.md
index 2f09f8c..7d181b3 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -24,6 +24,7 @@ custom-claude-skills/
 - The `scripts/install.sh` script creates symlinks from `~/.claude/skills/<name>` → this repo's `skills/<name>/`
 - After adding a new skill, run `./scripts/install.sh` to register it
 - Skills that are only useful for one project should live in that project's `.claude/skills/` instead
+- Every skill must have a corresponding `memory/skill-<name>.md` in `claude-foundations` with purpose, usage, how it works, and gotchas — update the `claude-foundations/MEMORY.md` index as part of the same commit
 
 ## Skill Development Guidelines