From 2d6a66f2d2168d57c7dc4000f2bc897c80580fd1 Mon Sep 17 00:00:00 2001 From: Justin Wilkin Date: Thu, 29 Oct 2026 17:45:00 +1100 Subject: [PATCH] refactor(quickstart): keep agent skills in .agents/skills Skills live in .agents/skills, which coding agents other than Claude Code read. .claude/skills is a symbolic link to it, so Claude Code loads the same files. AGENTS.md and the README point at the new path. --- {.claude => .agents}/skills/runkora-quickstart/SKILL.md | 0 .claude/skills | 1 + AGENTS.md | 2 +- README.md | 2 +- 4 files changed, 3 insertions(+), 2 deletions(-) rename {.claude => .agents}/skills/runkora-quickstart/SKILL.md (100%) create mode 120000 .claude/skills 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