feat(docs): add well-known skills discovery endpoint

Add `/.well-known/skills/index.json` endpoint to cli.sentry.dev for
agent skills auto-discovery, following the Cloudflare Agent Skills
Discovery RFC pattern.

- Create skills manifest at `docs/public/.well-known/skills/index.json`
- Update generate-skill.ts to output SKILL.md to both plugin and
  well-known paths
- Update generate-skill.yml workflow to commit both SKILL.md files
- Enables `npx skills add https://cli.sentry.dev` to auto-discover
  and install the sentry-cli skill

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

Author: sergical

.github/workflows/generate-skill.yml

@@ -37,7 +37,7 @@ jobs:
       - name: Check for changes
         id: diff
         run: |
-          if git diff --quiet plugins/sentry-cli/skills/sentry-cli/SKILL.md; then
+          if git diff --quiet plugins/sentry-cli/skills/sentry-cli/SKILL.md docs/public/.well-known/skills/sentry-cli/SKILL.md; then
             echo "changed=false" >> $GITHUB_OUTPUT
             echo "SKILL.md is already up to date"
           else
@@ -50,6 +50,6 @@ jobs:
         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 add plugins/sentry-cli/skills/sentry-cli/SKILL.md docs/public/.well-known/skills/sentry-cli/SKILL.md
           git commit -m "chore: Regenerate SKILL.md"
           git push

docs/public/.well-known/skills/index.json

@@ -0,0 +1,9 @@
+{
+  "skills": [
+    {
+      "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"]
+    }
+  ]
+}

script/generate-skill.ts

@@ -15,6 +15,7 @@
 import { routes } from "../src/app.js";
 
 const OUTPUT_PATH = "plugins/sentry-cli/skills/sentry-cli/SKILL.md";
+const WELL_KNOWN_PATH = "docs/public/.well-known/skills/sentry-cli/SKILL.md";
 const DOCS_PATH = "docs/src/content/docs";
 
 /** Regex to match YAML frontmatter at the start of a file */
@@ -772,5 +773,7 @@ async function generateSkillMarkdown(routeMap: RouteMap): Promise<string> {
 
 const content = await generateSkillMarkdown(routes as unknown as RouteMap);
 await Bun.write(OUTPUT_PATH, content);
+await Bun.write(WELL_KNOWN_PATH, content);
 
 console.log(`Generated ${OUTPUT_PATH}`);
+console.log(`Generated ${WELL_KNOWN_PATH}`);