From f8e8a43b1965ea5d69b6e20fcc0bf743ecc7a76d Mon Sep 17 00:00:00 2001
From: Cody De Arkland <codydearkland@gmail.com>
Date: Sun, 1 Mar 2026 23:42:52 -0800
Subject: [PATCH 1/3] feat(agent-skills): Update docs to match
 getsentry/sentry-for-ai repo
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The canonical agent skills repo moved from getsentry/sentry-agent-skills
to getsentry/sentry-for-ai. Skills were renamed (e.g. sentry-react-setup
→ sentry-react-sdk), three feature skills were consolidated into
per-platform SDK skills, and several new skills were added.

- Update repo name and skills.sh URLs across 26 files
- Rename setup skills to new -sdk naming convention
- Remove consolidated sentry-setup-{tracing,logging,metrics} skills
- Add new platform SDKs: Next.js, .NET, Go, Svelte, OTel exporter
- Add sentry-code-review to workflow skills table
- Add CI sync check script (warn-only, does not fail build)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 docs/ai/agent-skills.mdx                      | 35 ++++----
 docs/platforms/dotnet/common/logs/index.mdx   |  6 +-
 .../platforms/dotnet/common/metrics/index.mdx |  6 +-
 .../platforms/dotnet/common/tracing/index.mdx |  6 +-
 .../common/ai-agent-monitoring/index.mdx      |  6 +-
 .../javascript/common/metrics/index.mdx       |  6 +-
 .../javascript/common/tracing/index.mdx       |  6 +-
 .../javascript/guides/nextjs/logs/index.mdx   |  6 +-
 .../guides/nextjs/tracing/index.mdx           |  6 +-
 .../integrations/openai-agents/index.mdx      |  6 +-
 docs/platforms/python/logs/index.mdx          |  6 +-
 docs/platforms/python/metrics/index.mdx       |  6 +-
 docs/platforms/python/tracing/index.mdx       |  6 +-
 .../ai-agents-module.mdx                      |  6 +-
 docs/platforms/ruby/common/metrics/index.mdx  |  6 +-
 docs/platforms/ruby/common/tracing/index.mdx  |  6 +-
 docs/platforms/ruby/logs/index.mdx            |  6 +-
 package.json                                  |  3 +-
 platform-includes/llm-rules-logs/_default.mdx |  8 +-
 .../llm-rules-logs/javascript.nextjs.mdx      |  8 +-
 .../llm-rules-logs/javascript.node.mdx        |  8 +-
 .../llm-rules-logs/javascript.react.mdx       |  8 +-
 .../llm-rules-platform/_default.mdx           |  6 +-
 .../llm-rules-platform/javascript.nextjs.mdx  |  6 +-
 .../llm-rules-platform/javascript.node.mdx    |  6 +-
 .../llm-rules-platform/javascript.react.mdx   |  6 +-
 scripts/check-agent-skills-sync.mjs           | 86 +++++++++++++++++++
 27 files changed, 183 insertions(+), 93 deletions(-)
 create mode 100644 scripts/check-agent-skills-sync.mjs

diff --git a/docs/ai/agent-skills.mdx b/docs/ai/agent-skills.mdx
index e4958ca6f44ae..2dda3d05cb234 100644
--- a/docs/ai/agent-skills.mdx
+++ b/docs/ai/agent-skills.mdx
@@ -27,28 +27,28 @@ There are two types of official Sentry agent skills:
 - **Setup skills** - Set up Sentry in your projects with no manual configuration required.
 - **Workflow skills** - Debug and fix issues in your projects.
 
-Check out the latest and full list of skills [here](https://skills.sh/getsentry/sentry-agent-skills).
+Check out the latest and full list of skills [here](https://skills.sh/getsentry/sentry-for-ai).
 
 ## Install
 
 Run this in your project (or from any directory for user-level install) to add Sentry agent skills. Omit `--skill` to add all skills from the repo.
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills --skill sentry-fix-issues
+npx skills add getsentry/sentry-for-ai --skill sentry-fix-issues
 ```
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills --name sentry-fix-issues
+npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-fix-issues
 ```
 
 To add all Sentry skills:
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills
+npx skills add getsentry/sentry-for-ai
 ```
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills
+npx @sentry/dotagents add getsentry/sentry-for-ai
 ```
 
 Alternatively, use [dotagents](/ai/dotagents/) to manage skills declaratively with locked versions. Initialize your project, add Sentry skills, then install:
@@ -58,10 +58,10 @@ Alternatively, use [dotagents](/ai/dotagents/) to manage skills declaratively wi
 npx @sentry/dotagents init
 
 # Add a specific Sentry skill
-npx @sentry/dotagents add getsentry/sentry-agent-skills --name sentry-fix-issues
+npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-fix-issues
 
 # Or add all Sentry skills
-npx @sentry/dotagents add getsentry/sentry-agent-skills
+npx @sentry/dotagents add getsentry/sentry-for-ai
 
 # Install all declared skills
 npx @sentry/dotagents install
@@ -96,15 +96,17 @@ Once installed, your AI assistant will automatically discover the skills. Simply
 
 | What to Say                                | Skill Used                   |
 | ------------------------------------------ | ---------------------------- |
-| "Add Sentry to my React app"               | `sentry-react-setup`         |
-| "Set up Sentry in React Native"            | `sentry-react-native-setup`  |
-| "Add Sentry to my Python/Django/Flask app" | `sentry-python-setup`        |
-| "Set up Sentry in my Ruby/Rails app"       | `sentry-ruby-setup`          |
-| "Add Sentry to my iOS app"                 | `sentry-ios-swift-setup`     |
-| "Add performance monitoring to my app"     | `sentry-setup-tracing`       |
-| "Enable Sentry logging"                    | `sentry-setup-logging`       |
-| "Track custom metrics with Sentry"         | `sentry-setup-metrics`       |
+| "Add Sentry to my React app"               | `sentry-react-sdk`           |
+| "Set up Sentry in React Native"            | `sentry-react-native-sdk`    |
+| "Add Sentry to my Python/Django/Flask app" | `sentry-python-sdk`          |
+| "Set up Sentry in my Ruby/Rails app"       | `sentry-ruby-sdk`            |
+| "Add Sentry to my iOS app"                 | `sentry-cocoa-sdk`           |
+| "Add Sentry to my Next.js app"             | `sentry-nextjs-sdk`          |
+| "Add Sentry to my .NET app"                | `sentry-dotnet-sdk`          |
+| "Add Sentry to my Go app"                  | `sentry-go-sdk`              |
+| "Add Sentry to my Svelte app"              | `sentry-svelte-sdk`          |
 | "Monitor my OpenAI/LangChain calls"        | `sentry-setup-ai-monitoring` |
+| "Set up OpenTelemetry exporter"            | `sentry-otel-exporter-setup` |
 
 ### Debugging & Workflow
 
@@ -115,6 +117,7 @@ Once installed, your AI assistant will automatically discover the skills. Simply
 | "Work through my Sentry backlog"                                     | `sentry-fix-issues`     |
 | "Review Sentry comments on PR #123"                                  | `sentry-pr-code-review` |
 | "Fix the issues Sentry found in my PR"                               | `sentry-pr-code-review` |
+| "Review Sentry bot comments on my PR"                                | `sentry-code-review`    |
 | "Create an alert that emails me when a high priority issue resolves" | `sentry-create-alert`   |
 | "Set up a Slack notification for new Sentry issues"                  | `sentry-create-alert`   |
 
@@ -159,6 +162,6 @@ Instructions for the AI assistant...
 - Add troubleshooting tables for common issues
 - Target ~100-200 lines per skill to minimize token usage
 
-Submit contributions to the [sentry-agent-skills repository](https://github.com/getsentry/sentry-agent-skills).
+Submit contributions to the [sentry-for-ai repository](https://github.com/getsentry/sentry-for-ai).
 
 </StepComponent>
diff --git a/docs/platforms/dotnet/common/logs/index.mdx b/docs/platforms/dotnet/common/logs/index.mdx
index 13fac1464347b..f620232f2ee5f 100644
--- a/docs/platforms/dotnet/common/logs/index.mdx
+++ b/docs/platforms/dotnet/common/logs/index.mdx
@@ -19,14 +19,14 @@ Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assis
 ### Install Skills
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills --name sentry-setup-logging
+npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-dotnet-sdk
 ```
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills --skill sentry-setup-logging
+npx skills add getsentry/sentry-for-ai --skill sentry-dotnet-sdk
 ```
 
-See the [full list of available skills](https://skills.sh/getsentry/sentry-agent-skills) and [installation docs](/ai/agent-skills/) for more details.
+See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.
 
 </Expandable>
 
diff --git a/docs/platforms/dotnet/common/metrics/index.mdx b/docs/platforms/dotnet/common/metrics/index.mdx
index 716378fcfb4e2..76cd80bd8929f 100644
--- a/docs/platforms/dotnet/common/metrics/index.mdx
+++ b/docs/platforms/dotnet/common/metrics/index.mdx
@@ -14,14 +14,14 @@ Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assis
 ### Install Skills
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills --name sentry-setup-metrics
+npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-dotnet-sdk
 ```
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills --skill sentry-setup-metrics
+npx skills add getsentry/sentry-for-ai --skill sentry-dotnet-sdk
 ```
 
-See the [full list of available skills](https://skills.sh/getsentry/sentry-agent-skills) and [installation docs](/ai/agent-skills/) for more details.
+See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.
 
 </Expandable>
 
diff --git a/docs/platforms/dotnet/common/tracing/index.mdx b/docs/platforms/dotnet/common/tracing/index.mdx
index 43217120322cc..6b8dbc51dc626 100644
--- a/docs/platforms/dotnet/common/tracing/index.mdx
+++ b/docs/platforms/dotnet/common/tracing/index.mdx
@@ -13,14 +13,14 @@ Install Sentry’s [agent skills](/ai/agent-skills/) to teach your AI coding ass
 ### Install Skills
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills --name sentry-setup-tracing
+npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-dotnet-sdk
 ```
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills --skill sentry-setup-tracing
+npx skills add getsentry/sentry-for-ai --skill sentry-dotnet-sdk
 ```
 
-See the [full list of available skills](https://skills.sh/getsentry/sentry-agent-skills) and [installation docs](/ai/agent-skills/) for more details.
+See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.
 
 </Expandable>
 
diff --git a/docs/platforms/javascript/common/ai-agent-monitoring/index.mdx b/docs/platforms/javascript/common/ai-agent-monitoring/index.mdx
index cf5b7c3912142..f884390e00dcd 100644
--- a/docs/platforms/javascript/common/ai-agent-monitoring/index.mdx
+++ b/docs/platforms/javascript/common/ai-agent-monitoring/index.mdx
@@ -38,14 +38,14 @@ Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assis
 ### Install Skills
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills --name sentry-setup-ai-monitoring
+npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-setup-ai-monitoring
 ```
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills --skill sentry-setup-ai-monitoring
+npx skills add getsentry/sentry-for-ai --skill sentry-setup-ai-monitoring
 ```
 
-See the [full list of available skills](https://skills.sh/getsentry/sentry-agent-skills) and [installation docs](/ai/agent-skills/) for more details.
+See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.
 
 </Expandable>
 
diff --git a/docs/platforms/javascript/common/metrics/index.mdx b/docs/platforms/javascript/common/metrics/index.mdx
index a8e8e878055a7..e1dafa7f6ab81 100644
--- a/docs/platforms/javascript/common/metrics/index.mdx
+++ b/docs/platforms/javascript/common/metrics/index.mdx
@@ -17,14 +17,14 @@ Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assis
 ### Install Skills
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills --name sentry-setup-metrics
+npx @sentry/dotagents add getsentry/sentry-for-ai --all
 ```
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills --skill sentry-setup-metrics
+npx skills add getsentry/sentry-for-ai
 ```
 
-See the [full list of available skills](https://skills.sh/getsentry/sentry-agent-skills) and [installation docs](/ai/agent-skills/) for more details.
+See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.
 
 </Expandable>
 
diff --git a/docs/platforms/javascript/common/tracing/index.mdx b/docs/platforms/javascript/common/tracing/index.mdx
index 90ef301918f01..40629770c610f 100644
--- a/docs/platforms/javascript/common/tracing/index.mdx
+++ b/docs/platforms/javascript/common/tracing/index.mdx
@@ -13,14 +13,14 @@ Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assis
 ### Install Skills
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills --name sentry-setup-tracing
+npx @sentry/dotagents add getsentry/sentry-for-ai --all
 ```
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills --skill sentry-setup-tracing
+npx skills add getsentry/sentry-for-ai
 ```
 
-See the [full list of available skills](https://skills.sh/getsentry/sentry-agent-skills) and [installation docs](/ai/agent-skills/) for more details.
+See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.
 
 </Expandable>
 
diff --git a/docs/platforms/javascript/guides/nextjs/logs/index.mdx b/docs/platforms/javascript/guides/nextjs/logs/index.mdx
index bae6030edd6f7..c2317929b01c1 100644
--- a/docs/platforms/javascript/guides/nextjs/logs/index.mdx
+++ b/docs/platforms/javascript/guides/nextjs/logs/index.mdx
@@ -14,14 +14,14 @@ Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assis
 ### Install Skills
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills --name sentry-setup-logging
+npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-nextjs-sdk
 ```
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills --skill sentry-setup-logging
+npx skills add getsentry/sentry-for-ai --skill sentry-nextjs-sdk
 ```
 
-See the [full list of available skills](https://skills.sh/getsentry/sentry-agent-skills) and [installation docs](/ai/agent-skills/) for more details.
+See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.
 
 </Expandable>
 
diff --git a/docs/platforms/javascript/guides/nextjs/tracing/index.mdx b/docs/platforms/javascript/guides/nextjs/tracing/index.mdx
index 9adf273142d22..3b26f4c0eb4a5 100644
--- a/docs/platforms/javascript/guides/nextjs/tracing/index.mdx
+++ b/docs/platforms/javascript/guides/nextjs/tracing/index.mdx
@@ -13,14 +13,14 @@ Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assis
 ### Install Skills
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills --name sentry-setup-tracing
+npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-nextjs-sdk
 ```
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills --skill sentry-setup-tracing
+npx skills add getsentry/sentry-for-ai --skill sentry-nextjs-sdk
 ```
 
-See the [full list of available skills](https://skills.sh/getsentry/sentry-agent-skills) and [installation docs](/ai/agent-skills/) for more details.
+See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.
 
 </Expandable>
 
diff --git a/docs/platforms/python/integrations/openai-agents/index.mdx b/docs/platforms/python/integrations/openai-agents/index.mdx
index c30e347bc4f95..6b8e4869189bb 100644
--- a/docs/platforms/python/integrations/openai-agents/index.mdx
+++ b/docs/platforms/python/integrations/openai-agents/index.mdx
@@ -19,14 +19,14 @@ Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assis
 ### Install Skills
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills --name sentry-setup-ai-monitoring
+npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-setup-ai-monitoring
 ```
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills --skill sentry-setup-ai-monitoring
+npx skills add getsentry/sentry-for-ai --skill sentry-setup-ai-monitoring
 ```
 
-See the [full list of available skills](https://skills.sh/getsentry/sentry-agent-skills) and [installation docs](/ai/agent-skills/) for more details.
+See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.
 
 </Expandable>
 
diff --git a/docs/platforms/python/logs/index.mdx b/docs/platforms/python/logs/index.mdx
index 0a93e2c07580f..59d9727a75951 100644
--- a/docs/platforms/python/logs/index.mdx
+++ b/docs/platforms/python/logs/index.mdx
@@ -14,14 +14,14 @@ Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assis
 ### Install Skills
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills --name sentry-setup-logging
+npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-python-sdk
 ```
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills --skill sentry-setup-logging
+npx skills add getsentry/sentry-for-ai --skill sentry-python-sdk
 ```
 
-See the [full list of available skills](https://skills.sh/getsentry/sentry-agent-skills) and [installation docs](/ai/agent-skills/) for more details.
+See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.
 
 </Expandable>
 
diff --git a/docs/platforms/python/metrics/index.mdx b/docs/platforms/python/metrics/index.mdx
index 16913ab5c47b6..5743e9ab50544 100644
--- a/docs/platforms/python/metrics/index.mdx
+++ b/docs/platforms/python/metrics/index.mdx
@@ -14,14 +14,14 @@ Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assis
 ### Install Skills
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills --name sentry-setup-metrics
+npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-python-sdk
 ```
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills --skill sentry-setup-metrics
+npx skills add getsentry/sentry-for-ai --skill sentry-python-sdk
 ```
 
-See the [full list of available skills](https://skills.sh/getsentry/sentry-agent-skills) and [installation docs](/ai/agent-skills/) for more details.
+See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.
 
 </Expandable>
 
diff --git a/docs/platforms/python/tracing/index.mdx b/docs/platforms/python/tracing/index.mdx
index 3a70eeba71395..813d27fcbdbb6 100644
--- a/docs/platforms/python/tracing/index.mdx
+++ b/docs/platforms/python/tracing/index.mdx
@@ -13,14 +13,14 @@ Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assis
 ### Install Skills
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills --name sentry-setup-tracing
+npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-python-sdk
 ```
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills --skill sentry-setup-tracing
+npx skills add getsentry/sentry-for-ai --skill sentry-python-sdk
 ```
 
-See the [full list of available skills](https://skills.sh/getsentry/sentry-agent-skills) and [installation docs](/ai/agent-skills/) for more details.
+See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.
 
 </Expandable>
 
diff --git a/docs/platforms/python/tracing/instrumentation/custom-instrumentation/ai-agents-module.mdx b/docs/platforms/python/tracing/instrumentation/custom-instrumentation/ai-agents-module.mdx
index 75290a13c82b8..9ddb211cf4200 100644
--- a/docs/platforms/python/tracing/instrumentation/custom-instrumentation/ai-agents-module.mdx
+++ b/docs/platforms/python/tracing/instrumentation/custom-instrumentation/ai-agents-module.mdx
@@ -13,14 +13,14 @@ Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assis
 ### Install Skills
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills --name sentry-setup-ai-monitoring
+npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-setup-ai-monitoring
 ```
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills --skill sentry-setup-ai-monitoring
+npx skills add getsentry/sentry-for-ai --skill sentry-setup-ai-monitoring
 ```
 
-See the [full list of available skills](https://skills.sh/getsentry/sentry-agent-skills) and [installation docs](/ai/agent-skills/) for more details.
+See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.
 
 </Expandable>
 
diff --git a/docs/platforms/ruby/common/metrics/index.mdx b/docs/platforms/ruby/common/metrics/index.mdx
index ece5b06dbeb82..0c9b935eb85f7 100644
--- a/docs/platforms/ruby/common/metrics/index.mdx
+++ b/docs/platforms/ruby/common/metrics/index.mdx
@@ -14,14 +14,14 @@ Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assis
 ### Install Skills
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills --name sentry-setup-metrics
+npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-ruby-sdk
 ```
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills --skill sentry-setup-metrics
+npx skills add getsentry/sentry-for-ai --skill sentry-ruby-sdk
 ```
 
-See the [full list of available skills](https://skills.sh/getsentry/sentry-agent-skills) and [installation docs](/ai/agent-skills/) for more details.
+See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.
 
 </Expandable>
 
diff --git a/docs/platforms/ruby/common/tracing/index.mdx b/docs/platforms/ruby/common/tracing/index.mdx
index 295f0280b3697..00f1031289435 100644
--- a/docs/platforms/ruby/common/tracing/index.mdx
+++ b/docs/platforms/ruby/common/tracing/index.mdx
@@ -13,14 +13,14 @@ Install Sentry’s [agent skills](/ai/agent-skills/) to teach your AI coding ass
 ### Install Skills
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills --name sentry-setup-tracing
+npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-ruby-sdk
 ```
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills --skill sentry-setup-tracing
+npx skills add getsentry/sentry-for-ai --skill sentry-ruby-sdk
 ```
 
-See the [full list of available skills](https://skills.sh/getsentry/sentry-agent-skills) and [installation docs](/ai/agent-skills/) for more details.
+See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.
 
 </Expandable>
 
diff --git a/docs/platforms/ruby/logs/index.mdx b/docs/platforms/ruby/logs/index.mdx
index 200d686d44022..51c44b5621632 100644
--- a/docs/platforms/ruby/logs/index.mdx
+++ b/docs/platforms/ruby/logs/index.mdx
@@ -14,14 +14,14 @@ Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assis
 ### Install Skills
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills --name sentry-setup-logging
+npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-ruby-sdk
 ```
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills --skill sentry-setup-logging
+npx skills add getsentry/sentry-for-ai --skill sentry-ruby-sdk
 ```
 
-See the [full list of available skills](https://skills.sh/getsentry/sentry-agent-skills) and [installation docs](/ai/agent-skills/) for more details.
+See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.
 
 </Expandable>
 
diff --git a/package.json b/package.json
index c94c057e9fae2..124d90ce0c94c 100644
--- a/package.json
+++ b/package.json
@@ -34,7 +34,8 @@
     "sidecar": "spotlight-sidecar",
     "test": "vitest",
     "test:ci": "vitest run",
-    "enforce-redirects": "node ./scripts/no-vercel-json-redirects.mjs"
+    "enforce-redirects": "node ./scripts/no-vercel-json-redirects.mjs",
+    "check:skills-sync": "node scripts/check-agent-skills-sync.mjs"
   },
   "dependencies": {
     "@ariakit/react": "^0.4.5",
diff --git a/platform-includes/llm-rules-logs/_default.mdx b/platform-includes/llm-rules-logs/_default.mdx
index 4b7360faa788c..21cd05f7275e6 100644
--- a/platform-includes/llm-rules-logs/_default.mdx
+++ b/platform-includes/llm-rules-logs/_default.mdx
@@ -1,17 +1,17 @@
 <Expandable title="Sentry Agent Skills" copy="Copy Install Command" hideFromMd={true}>
 
-Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assistant how to set up logging in your application.
+Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assistant how to set up Sentry in your application.
 
 ### Install Skills
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills --name sentry-setup-logging
+npx @sentry/dotagents add getsentry/sentry-for-ai --all
 ```
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills --skill sentry-setup-logging
+npx skills add getsentry/sentry-for-ai
 ```
 
-See the [full list of available skills](https://skills.sh/getsentry/sentry-agent-skills) and [installation docs](/ai/agent-skills/) for more details.
+See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.
 
 </Expandable>
diff --git a/platform-includes/llm-rules-logs/javascript.nextjs.mdx b/platform-includes/llm-rules-logs/javascript.nextjs.mdx
index df3c71c1f16d6..b2ea105e8c5c0 100644
--- a/platform-includes/llm-rules-logs/javascript.nextjs.mdx
+++ b/platform-includes/llm-rules-logs/javascript.nextjs.mdx
@@ -1,17 +1,17 @@
 <Expandable title="Sentry Agent Skills" copy="Copy Install Command" hideFromMd={true}>
 
-Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assistant how to set up logging in your Next.js application.
+Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assistant how to set up Sentry in your Next.js application.
 
 ### Install Skills
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills --name sentry-setup-logging
+npx @sentry/dotagents add getsentry/sentry-for-ai --all
 ```
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills --skill sentry-setup-logging
+npx skills add getsentry/sentry-for-ai
 ```
 
-See the [full list of available skills](https://skills.sh/getsentry/sentry-agent-skills) and [installation docs](/ai/agent-skills/) for more details.
+See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.
 
 </Expandable>
diff --git a/platform-includes/llm-rules-logs/javascript.node.mdx b/platform-includes/llm-rules-logs/javascript.node.mdx
index 1e9b6a3c9f59d..dc76a95b805a0 100644
--- a/platform-includes/llm-rules-logs/javascript.node.mdx
+++ b/platform-includes/llm-rules-logs/javascript.node.mdx
@@ -1,17 +1,17 @@
 <Expandable title="Sentry Agent Skills" copy="Copy Install Command" hideFromMd={true}>
 
-Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assistant how to set up logging in your Node.js application.
+Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assistant how to set up Sentry in your Node.js application.
 
 ### Install Skills
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills --name sentry-setup-logging
+npx @sentry/dotagents add getsentry/sentry-for-ai --all
 ```
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills --skill sentry-setup-logging
+npx skills add getsentry/sentry-for-ai
 ```
 
-See the [full list of available skills](https://skills.sh/getsentry/sentry-agent-skills) and [installation docs](/ai/agent-skills/) for more details.
+See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.
 
 </Expandable>
diff --git a/platform-includes/llm-rules-logs/javascript.react.mdx b/platform-includes/llm-rules-logs/javascript.react.mdx
index 1c8f85eb50380..037c1b12814a2 100644
--- a/platform-includes/llm-rules-logs/javascript.react.mdx
+++ b/platform-includes/llm-rules-logs/javascript.react.mdx
@@ -1,17 +1,17 @@
 <Expandable title="Sentry Agent Skills" copy="Copy Install Command" hideFromMd={true}>
 
-Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assistant how to set up logging in your React application.
+Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assistant how to set up Sentry in your React application.
 
 ### Install Skills
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills --name sentry-setup-logging
+npx @sentry/dotagents add getsentry/sentry-for-ai --all
 ```
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills --skill sentry-setup-logging
+npx skills add getsentry/sentry-for-ai
 ```
 
-See the [full list of available skills](https://skills.sh/getsentry/sentry-agent-skills) and [installation docs](/ai/agent-skills/) for more details.
+See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.
 
 </Expandable>
diff --git a/platform-includes/llm-rules-platform/_default.mdx b/platform-includes/llm-rules-platform/_default.mdx
index 544a29fa10cbb..73a109a23dee9 100644
--- a/platform-includes/llm-rules-platform/_default.mdx
+++ b/platform-includes/llm-rules-platform/_default.mdx
@@ -5,13 +5,13 @@ Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assis
 ### Install Skills
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills --all
+npx @sentry/dotagents add getsentry/sentry-for-ai --all
 ```
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills
+npx skills add getsentry/sentry-for-ai
 ```
 
-See the [full list of available skills](https://skills.sh/getsentry/sentry-agent-skills) and [installation docs](/ai/agent-skills/) for more details.
+See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.
 
 </Expandable>
diff --git a/platform-includes/llm-rules-platform/javascript.nextjs.mdx b/platform-includes/llm-rules-platform/javascript.nextjs.mdx
index d3204dad81003..bcc73e8f87fd1 100644
--- a/platform-includes/llm-rules-platform/javascript.nextjs.mdx
+++ b/platform-includes/llm-rules-platform/javascript.nextjs.mdx
@@ -5,13 +5,13 @@ Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assis
 ### Install Skills
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills --all
+npx @sentry/dotagents add getsentry/sentry-for-ai --all
 ```
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills
+npx skills add getsentry/sentry-for-ai
 ```
 
-See the [full list of available skills](https://skills.sh/getsentry/sentry-agent-skills) and [installation docs](/ai/agent-skills/) for more details.
+See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.
 
 </Expandable>
diff --git a/platform-includes/llm-rules-platform/javascript.node.mdx b/platform-includes/llm-rules-platform/javascript.node.mdx
index 3c1f03e483921..bd7d67afe0761 100644
--- a/platform-includes/llm-rules-platform/javascript.node.mdx
+++ b/platform-includes/llm-rules-platform/javascript.node.mdx
@@ -5,13 +5,13 @@ Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assis
 ### Install Skills
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills --all
+npx @sentry/dotagents add getsentry/sentry-for-ai --all
 ```
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills
+npx skills add getsentry/sentry-for-ai
 ```
 
-See the [full list of available skills](https://skills.sh/getsentry/sentry-agent-skills) and [installation docs](/ai/agent-skills/) for more details.
+See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.
 
 </Expandable>
diff --git a/platform-includes/llm-rules-platform/javascript.react.mdx b/platform-includes/llm-rules-platform/javascript.react.mdx
index 7bbfca9685d98..3e8e45de98e56 100644
--- a/platform-includes/llm-rules-platform/javascript.react.mdx
+++ b/platform-includes/llm-rules-platform/javascript.react.mdx
@@ -5,13 +5,13 @@ Install Sentry's [agent skills](/ai/agent-skills/) to teach your AI coding assis
 ### Install Skills
 
 ```bash {tabTitle: dotagents}
-npx @sentry/dotagents add getsentry/sentry-agent-skills --all
+npx @sentry/dotagents add getsentry/sentry-for-ai --all
 ```
 
 ```bash {tabTitle: npx skills}
-npx skills add getsentry/sentry-agent-skills
+npx skills add getsentry/sentry-for-ai
 ```
 
-See the [full list of available skills](https://skills.sh/getsentry/sentry-agent-skills) and [installation docs](/ai/agent-skills/) for more details.
+See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.
 
 </Expandable>
diff --git a/scripts/check-agent-skills-sync.mjs b/scripts/check-agent-skills-sync.mjs
new file mode 100644
index 0000000000000..b535283549a0a
--- /dev/null
+++ b/scripts/check-agent-skills-sync.mjs
@@ -0,0 +1,86 @@
+/**
+ * Checks that the agent skills documented in docs/ai/agent-skills.mdx
+ * are in sync with the skills in the getsentry/sentry-for-ai repository.
+ *
+ * Usage: node scripts/check-agent-skills-sync.mjs
+ *
+ * Requires: `gh` CLI authenticated, or GITHUB_TOKEN env var.
+ * Exit code: always 0 (warn-only, does not fail the build).
+ */
+
+import {execSync} from 'node:child_process';
+import {readFileSync} from 'node:fs';
+import {resolve, dirname} from 'node:path';
+import {fileURLToPath} from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const REPO = 'getsentry/sentry-for-ai';
+const DOCS_PATH = resolve(__dirname, '../docs/ai/agent-skills.mdx');
+
+async function getRepoSkills() {
+  try {
+    const output = execSync(
+      `gh api repos/${REPO}/contents/skills --jq '.[].name'`,
+      {encoding: 'utf-8', timeout: 15000}
+    );
+    return output
+      .trim()
+      .split('\n')
+      .filter(name => name && !name.startsWith('.'));
+  } catch (err) {
+    console.error('Failed to fetch skills from GitHub. Is `gh` CLI installed and authenticated?');
+    console.error(err.message);
+    process.exit(2);
+  }
+}
+
+function getDocSkills() {
+  const content = readFileSync(DOCS_PATH, 'utf-8');
+  const skills = new Set();
+
+  // Match backtick-wrapped skill names in table rows (e.g. `sentry-react-sdk`)
+  const tableRowRegex = /\|\s*`([^`]+)`\s*\|/g;
+  let match;
+  while ((match = tableRowRegex.exec(content)) !== null) {
+    skills.add(match[1]);
+  }
+
+  return [...skills];
+}
+
+async function main() {
+  console.log(`Checking agent skills sync between docs and ${REPO}...\n`);
+
+  const repoSkills = await getRepoSkills();
+  const docSkills = getDocSkills();
+
+  const repoSet = new Set(repoSkills);
+  const docSet = new Set(docSkills);
+
+  const missingFromDocs = repoSkills.filter(s => !docSet.has(s));
+  const missingFromRepo = docSkills.filter(s => !repoSet.has(s));
+
+  let drifted = false;
+
+  if (missingFromDocs.length > 0) {
+    console.log('Skills in repo but MISSING from docs:');
+    missingFromDocs.forEach(s => console.log(`  - ${s}`));
+    console.log();
+    drifted = true;
+  }
+
+  if (missingFromRepo.length > 0) {
+    console.log('Skills in docs but NOT in repo:');
+    missingFromRepo.forEach(s => console.log(`  - ${s}`));
+    console.log();
+    drifted = true;
+  }
+
+  if (!drifted) {
+    console.log(`All ${repoSkills.length} repo skills are documented. No drift detected.`);
+  } else {
+    console.warn('⚠ Drift detected — please update docs/ai/agent-skills.mdx to match the repo.');
+  }
+}
+
+main();

From 4dcee2ebee3b06d86618156446b5ff5fd210990f Mon Sep 17 00:00:00 2001
From: "getsantry[bot]" <66042841+getsantry[bot]@users.noreply.github.com>
Date: Mon, 2 Mar 2026 07:44:05 +0000
Subject: [PATCH 2/3] [getsentry/action-github-commit] Auto commit

---
 scripts/check-agent-skills-sync.mjs | 20 +++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

diff --git a/scripts/check-agent-skills-sync.mjs b/scripts/check-agent-skills-sync.mjs
index b535283549a0a..7fbc580b58f4f 100644
--- a/scripts/check-agent-skills-sync.mjs
+++ b/scripts/check-agent-skills-sync.mjs
@@ -19,16 +19,18 @@ const DOCS_PATH = resolve(__dirname, '../docs/ai/agent-skills.mdx');
 
 async function getRepoSkills() {
   try {
-    const output = execSync(
-      `gh api repos/${REPO}/contents/skills --jq '.[].name'`,
-      {encoding: 'utf-8', timeout: 15000}
-    );
+    const output = execSync(`gh api repos/${REPO}/contents/skills --jq '.[].name'`, {
+      encoding: 'utf-8',
+      timeout: 15000,
+    });
     return output
       .trim()
       .split('\n')
       .filter(name => name && !name.startsWith('.'));
   } catch (err) {
-    console.error('Failed to fetch skills from GitHub. Is `gh` CLI installed and authenticated?');
+    console.error(
+      'Failed to fetch skills from GitHub. Is `gh` CLI installed and authenticated?'
+    );
     console.error(err.message);
     process.exit(2);
   }
@@ -77,9 +79,13 @@ async function main() {
   }
 
   if (!drifted) {
-    console.log(`All ${repoSkills.length} repo skills are documented. No drift detected.`);
+    console.log(
+      `All ${repoSkills.length} repo skills are documented. No drift detected.`
+    );
   } else {
-    console.warn('⚠ Drift detected — please update docs/ai/agent-skills.mdx to match the repo.');
+    console.warn(
+      '⚠ Drift detected — please update docs/ai/agent-skills.mdx to match the repo.'
+    );
   }
 }
 

From 2cb1686ff9c04a30d41168b4c78218a1d59b46f9 Mon Sep 17 00:00:00 2001
From: Cody De Arkland <codydearkland@gmail.com>
Date: Tue, 3 Mar 2026 11:36:00 -0800
Subject: [PATCH 3/3] fix(agent-skills): Address PR review comments on sync
 script

- Replace process.exit(2) with return [] so the script honors its
  documented "always exit 0" warn-only contract
- Wrap top-level main() in .catch() to handle unhandled rejections
- Tighten regex to only match lowercase slug patterns, avoiding
  false matches on file paths like ~/.claude/skills/

Co-Authored-By: Claude <noreply@anthropic.com>
---
 scripts/check-agent-skills-sync.mjs | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/scripts/check-agent-skills-sync.mjs b/scripts/check-agent-skills-sync.mjs
index 7fbc580b58f4f..c83dcb7fabfe2 100644
--- a/scripts/check-agent-skills-sync.mjs
+++ b/scripts/check-agent-skills-sync.mjs
@@ -32,7 +32,7 @@ async function getRepoSkills() {
       'Failed to fetch skills from GitHub. Is `gh` CLI installed and authenticated?'
     );
     console.error(err.message);
-    process.exit(2);
+    return [];
   }
 }
 
@@ -41,7 +41,8 @@ function getDocSkills() {
   const skills = new Set();
 
   // Match backtick-wrapped skill names in table rows (e.g. `sentry-react-sdk`)
-  const tableRowRegex = /\|\s*`([^`]+)`\s*\|/g;
+  // Only match names that look like skill slugs (alphanumeric with hyphens), not file paths
+  const tableRowRegex = /\|\s*`([a-z0-9][a-z0-9-]*)`\s*\|/g;
   let match;
   while ((match = tableRowRegex.exec(content)) !== null) {
     skills.add(match[1]);
@@ -89,4 +90,7 @@ async function main() {
   }
 }
 
-main();
+main().catch(err => {
+  console.error('Unexpected error:', err.message);
+  process.exit(0);
+});