diff --git a/.agents/skills b/.agents/skills
new file mode 120000
index 00000000..42c5394a
--- /dev/null
+++ b/.agents/skills
@@ -0,0 +1 @@
+../skills
\ No newline at end of file
diff --git a/.claude/skills b/.claude/skills
new file mode 120000
index 00000000..42c5394a
--- /dev/null
+++ b/.claude/skills
@@ -0,0 +1 @@
+../skills
\ No newline at end of file
diff --git a/.gitignore b/.gitignore
index 9c3b5469..90da9be1 100644
--- a/.gitignore
+++ b/.gitignore
@@ -80,8 +80,9 @@ extras/speaker-omni-experimental/cache/*
 # Discovery agent PID file
 edge/.discovery-agent.pid
 
-# AI Stuff
-.claude
+# AI Stuff: keep machine-local Claude state ignored, but track the shared skill link.
+.claude/*
+!.claude/skills
 
 # SSL / TLS certificates (centralized)
 certs/*.crt