Skip to content

Commit 510f36d

Browse files
committed
removing symlinks
Signed-off-by: Seonghee Lee <seongheel@nvidia.com>
1 parent 1e5664d commit 510f36d

4 files changed

Lines changed: 5 additions & 39 deletions

File tree

.agents/README.md

Lines changed: 5 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -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:
6037
3. `<repo-root>/.claude/clusters.yaml` (project-level, back-compat)
6138

6239
See `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.

.claude/clusters.yaml.example

Lines changed: 0 additions & 1 deletion
This file was deleted.

.claude/scripts

Lines changed: 0 additions & 1 deletion
This file was deleted.

.claude/skills

Lines changed: 0 additions & 1 deletion
This file was deleted.

0 commit comments

Comments
 (0)