chore(skills): make .agents/skills the canonical skills directory (#15550)

.agents/skills/sync-vendored-skills.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
-### Syncs each vendored skills repo in UPSTREAMS into .cursor/skills/<dir>,
+### Syncs each vendored skills repo in UPSTREAMS into .agents/skills/<dir>,
 ### and maintains the top-level symlinks that expose each vendored skill at
-### .cursor/skills/<name> (agents discover skills at
+### .agents/skills/<name> (agents discover skills at
 ### <skills-dir>/<name>/SKILL.md, so a multi-skill repo needs one symlink
 ### per skill).
 ###
@@ -15,12 +15,12 @@
 
 set -euo pipefail
 
-# One entry per vendored skills repo: "<dir under .cursor/skills> <url> <ref>".
+# One entry per vendored skills repo: "<dir under .agents/skills> <url> <ref>".
 UPSTREAMS=(
   "greptile https://github.com/greptileai/skills.git main"
 )
 
-SKILLS_DIR=".cursor/skills"
+SKILLS_DIR=".agents/skills"
 
 cd "$(git rev-parse --show-toplevel)"
 

.claude/skills

@@ -1 +1 @@
-../.cursor/skills
+../.agents/skills

.codex/skills

@@ -0,0 +1 @@
+../.agents/skills

.cursor/skills

@@ -0,0 +1 @@
+../.agents/skills

.github/workflows/update-vendored-skills.yml

@@ -1,5 +1,5 @@
-### Syncs the vendored skill repos under .cursor/skills (the UPSTREAMS list
-### in .cursor/skills/sync-vendored-skills.sh) and opens a reviewed PR when
+### Syncs the vendored skill repos under .agents/skills (the UPSTREAMS list
+### in .agents/skills/sync-vendored-skills.sh) and opens a reviewed PR when
 ### an upstream changed.
 
 name: Update Vendored Skills
@@ -50,7 +50,7 @@ jobs:
         id: sync
         run: |
           before="$(git rev-parse HEAD)"
-          ./.cursor/skills/sync-vendored-skills.sh
+          ./.agents/skills/sync-vendored-skills.sh
           if [ "$(git rev-parse HEAD)" != "${before}" ]; then
             echo "changed=true" >> "${GITHUB_OUTPUT}"
           fi
@@ -78,7 +78,7 @@ jobs:
               --base main \
               --head "${branch}" \
               --title "${title}" \
-              --body "Generated by the [Update Vendored Skills workflow run](${RUN_URL}). Synced by \`.cursor/skills/sync-vendored-skills.sh\`; its UPSTREAMS list names the vendored repos."
+              --body "Generated by the [Update Vendored Skills workflow run](${RUN_URL}). Synced by \`.agents/skills/sync-vendored-skills.sh\`; its UPSTREAMS list names the vendored repos."
           fi
 
   notify-slack-on-failure:

.gitignore

@@ -7,7 +7,7 @@
 !/.vscode/tasks.json
 .cursor/*
 !/.cursor/mcp.json
-!/.cursor/skills/
+!/.cursor/skills
 
 # macos
 .DS_store

AGENTS.md

@@ -52,6 +52,11 @@ there:
 
 Explore the tree with `ls` rather than relying on docs for the full package list.
 
+### Skills
+
+Shared agent skills live in `.agents/skills/`. `.claude/skills`, `.cursor/skills` and
+`.codex/skills` are symlinks to it, so add or edit skills only in `.agents/skills/`.
+
 ## Code Quality
 
 ```bash