diff --git a/.claude/skills/runkora-quickstart/SKILL.md b/.agents/skills/runkora-quickstart/SKILL.md
similarity index 100%
rename from .claude/skills/runkora-quickstart/SKILL.md
rename to .agents/skills/runkora-quickstart/SKILL.md
diff --git a/.claude/skills b/.claude/skills
new file mode 120000
index 0000000..2b7a412
--- /dev/null
+++ b/.claude/skills
@@ -0,0 +1 @@
+../.agents/skills
\ No newline at end of file
diff --git a/AGENTS.md b/AGENTS.md
index 45e88fd..f6d70fd 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -2,6 +2,6 @@
 
 This repository holds runnable examples for runkora and a quickstart that installs kora on a local k3d cluster.
 
-- **Quickstart:** When asked to set up, install or demo runkora, follow `.claude/skills/runkora-quickstart/SKILL.md`. Any coding agent can follow it.
+- **Quickstart:** When asked to set up, install or demo runkora, follow `.agents/skills/runkora-quickstart/SKILL.md`. Claude Code reads it through `.claude/skills`, a link to `.agents/skills`.
 - **Source of truth:** `quickstart/README.md` and each example's README hold the detail. Where the skill and a README disagree, follow the README.
 - **Manifests:** Run `make validate` after changing a manifest. CI runs the same check on every pull request.
diff --git a/README.md b/README.md
index 52cc5a6..0138b82 100644
--- a/README.md
+++ b/README.md
@@ -12,7 +12,7 @@ make up
 
 See [`quickstart`](quickstart) for the prerequisites and the install stages.
 
-A coding agent can also run the quickstart. Ask it to set up runkora from this repository, and it follows [`.claude/skills/runkora-quickstart/SKILL.md`](.claude/skills/runkora-quickstart/SKILL.md).
+A coding agent can also run the quickstart. Ask it to set up runkora from this repository, and it follows [`.agents/skills/runkora-quickstart/SKILL.md`](.agents/skills/runkora-quickstart/SKILL.md).
 
 ## Examples