@@ -15,37 +15,14 @@ working in this repository (Claude Code, Codex, Cursor, …).
1515
1616## Why this exists
1717
18- Different agents look for skills/config in vendor-specific directories:
19-
20- | Agent | Default location |
21- | -------------| -------------------------------|
22- | Claude Code | ` .claude/skills/ ` |
23- | Codex | ` .codex/skills/ ` |
24- | Cursor | ` .cursor/skills/ ` |
25-
26- Maintaining N copies of the same skill is a non-starter. Instead, ** ` .agents/ `
27- is the single source of truth** , and each vendor directory is a symlink:
28-
29- ``` text
30- .claude/skills -> ../.agents/skills
31- .claude/scripts -> ../.agents/scripts
32- .claude/clusters.yaml.example -> ../.agents/clusters.yaml.example
33- ```
34-
35- To add support for a new agent, create a directory with the symlinks that
36- agent expects, e.g.:
37-
38- ``` bash
39- mkdir -p .codex
40- ln -s ../.agents/skills .codex/skills
41- git add .codex/skills
42- ```
18+ Different agents look for skills/config in vendor-specific directories. Rather
19+ than maintaining N copies that drift out of sync, ** ` .agents/ ` is the single
20+ source of truth** — each agent's guidance or install mechanism points here
21+ directly.
4322
4423## Editing rules
4524
46- - ** Always edit files under ` .agents/ ` ** , never under the vendor symlink paths.
47- Edits via the symlink work, but the diff will look like changes to
48- ` .agents/... ` either way; editing the canonical path makes that explicit.
25+ - ** Always edit files under ` .agents/ ` ** .
4926- Vendored-verbatim skills (` launching-evals ` , ` accessing-mlflow ` ) are managed
5027 by ` .agents/scripts/sync-upstream-skills.sh ` — do not modify by hand.
5128- New skills go in ` .agents/skills/<skill-name>/SKILL.md ` following the
@@ -60,11 +37,3 @@ The remote-execution skills look for a `clusters.yaml` at, in order:
60373 . ` <repo-root>/.claude/clusters.yaml ` (project-level, back-compat)
6138
6239See ` clusters.yaml.example ` for the schema.
63-
64- ## A note on Windows
65-
66- Git stores symlinks portably, but Windows requires either Developer Mode or
67- ` git config --global core.symlinks true ` plus admin rights for them to
68- materialise correctly. If you're on Windows and skills aren't being picked
69- up under ` .claude/skills/ ` , that's the most likely cause — ` .agents/skills/ `
70- will still work directly.
0 commit comments