refactor: split skill docs into reference files and improve skill loader

Move verbose inline command documentation from SKILL.md into per-command
reference files under references/. Update generate-skill and check-skill
scripts to support the new structure, and refactor agent-skills loader
to resolve reference paths at runtime.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: betegon

.cursor/skills/sentry-cli/SKILL.md

@@ -110,22 +110,22 @@ jobs:
           key: node-modules-${{ hashFiles('bun.lock', 'patches/**') }}
       - if: steps.cache.outputs.cache-hit != 'true'
         run: bun install --frozen-lockfile
-      - name: Check SKILL.md
+      - name: Check skill files
         id: check
         run: bun run check:skill
         continue-on-error: true
-      - name: Auto-commit regenerated SKILL.md
+      - name: Auto-commit regenerated skill files
         if: steps.check.outcome == 'failure' && steps.token.outcome == 'success'
         run: |
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
-          git add plugins/sentry-cli/skills/sentry-cli/SKILL.md
-          git commit -m "chore: regenerate SKILL.md"
+          git add plugins/sentry-cli/skills/sentry-cli/ docs/public/.well-known/skills/index.json
+          git commit -m "chore: regenerate skill files"
           git push
-      - name: Fail for fork PRs with stale SKILL.md
+      - name: Fail for fork PRs with stale skill files
         if: steps.check.outcome == 'failure' && steps.token.outcome != 'success'
         run: |
-          echo "::error::SKILL.md is out of date. Run 'bun run generate:skill' locally and commit the result."
+          echo "::error::Skill files are out of date. Run 'bun run generate:skill' locally and commit the result."
           exit 1
 
   lint:

.github/workflows/ci.yml

@@ -3,7 +3,21 @@
     {
       "name": "sentry-cli",
       "description": "Guide for using the Sentry CLI to interact with Sentry from the command line. Use when the user asks about viewing issues, events, projects, organizations, making API calls, or authenticating with Sentry via CLI.",
-      "files": ["SKILL.md"]
+      "files": [
+        "SKILL.md",
+        "references/auth.md",
+        "references/org.md",
+        "references/project.md",
+        "references/issue.md",
+        "references/event.md",
+        "references/api.md",
+        "references/cli.md",
+        "references/repo.md",
+        "references/team.md",
+        "references/log.md",
+        "references/trace.md",
+        "references/init.md"
+      ]
     }
   ]
 }