feat: Redesign Agent Skills callout with copy-prompt UX

[HazAT]

Redesign Agent Skills Callout

Replaces the old Expandable-based "Sentry Agent Skills" callout with a new AgentSkillsCallout component across all platform docs.

New design

• "Agent-Assisted Setup" card with "Recommended" badge
• One-line prompt users copy directly into their coding agent (points to skills.sentry.gg short URLs)
• Collapsed by default with expandable section for full skills package installation
• Uses existing CodeTabs/CodeBlock components for the install commands (dotagents / npx skills tabs)
• Purple color scheme with light/dark mode support

How it works

The component takes just two props — everything else is derived internally:

• skill → generates prompt URL, dotagents --name, npx skills --skill
• platformName → used in description text
• No children needed — install commands with CodeTabs rendered internally

Changes

• New AgentSkillsCallout component (src/components/agentSkillsCallout/)
• Replaced all 23 old Expandable-based agent skills callouts
• Updated repo references from sentry-agent-skills to sentry-for-ai
• All prompt URLs point to skills.sentry.gg/{skill}/SKILL.md
• Added .yarn/install-state.gz to .gitignore

Platforms covered

Platform	Skill
Next.js	sentry-nextjs-sdk
Node.js	sentry-node-sdk
React	sentry-react-sdk
Python	sentry-python-sdk
.NET	sentry-dotnet-sdk
Ruby	sentry-ruby-sdk
AI monitoring	sentry-setup-ai-monitoring
Generic/default	(none — skills.sentry.gg/)

Co-Authored-By: Claude noreply@anthropic.com

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
develop-docs	Ready	Preview, Comment	Mar 6, 2026 10:52pm
sentry-docs	Ready	Preview, Comment	Mar 6, 2026 10:52pm

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Autofix Details

Bugbot Autofix prepared a fix for the issue found in the latest run.

• ✅ Fixed: Potentially nonexistent skill names generate broken prompt URLs
  • Removed the three AgentSkillsCallout components that referenced nonexistent skills (sentry-nestjs-sdk, sentry-android-sdk, sentry-php-sdk) from the NestJS, Android, and PHP index pages.

Or push these changes by commenting:

@cursor push fc26e663a6

Preview (fc26e663a6)

diff --git a/docs/platforms/android/index.mdx b/docs/platforms/android/index.mdx
--- a/docs/platforms/android/index.mdx
+++ b/docs/platforms/android/index.mdx
@@ -11,8 +11,6 @@
   - ndk
 ---
 
-<AgentSkillsCallout skill="sentry-android-sdk" platformName="Android" />
-
 On this page, we get you up and running with Sentry's Android SDK, automatically reporting errors and exceptions in your application.
 
 <Alert>

diff --git a/docs/platforms/javascript/guides/nestjs/index.mdx b/docs/platforms/javascript/guides/nestjs/index.mdx
--- a/docs/platforms/javascript/guides/nestjs/index.mdx
+++ b/docs/platforms/javascript/guides/nestjs/index.mdx
@@ -9,8 +9,6 @@
   - server-node
 ---
 
-<AgentSkillsCallout skill="sentry-nestjs-sdk" platformName="Nest.js" />
-
 <PlatformContent includePath="getting-started-prerequisites" />
 
 ## Step 1: Install

diff --git a/docs/platforms/php/index.mdx b/docs/platforms/php/index.mdx
--- a/docs/platforms/php/index.mdx
+++ b/docs/platforms/php/index.mdx
@@ -9,8 +9,6 @@
 og_image: /og-images/platforms-php.png
 ---
 
-<AgentSkillsCallout skill="sentry-php-sdk" platformName="PHP" />
-
 ## Prerequisites
 
 * You need a [Sentry account](https://sentry.io/signup/) and project

_{This Bugbot Autofix run was free. To enable autofix for future PRs, go to the Cursor dashboard.}

[cursor]

Potentially nonexistent skill names generate broken prompt URLs

Medium Severity

Three new callouts reference skill names (sentry-nestjs-sdk, sentry-android-sdk, sentry-php-sdk) that are not listed in the canonical skill table in docs/ai/agent-skills.mdx. These pages never had agent skills callouts before (they're new additions, not replacements of old Expandable blocks), so if these skills don't exist in the sentry-for-ai repo, the generated prompt URLs (e.g. https://skills.sentry.gg/sentry-nestjs-sdk/SKILL.md) will 404, and users copying the prompt will get a broken experience.

Additional Locations (2)

• docs/platforms/android/index.mdx#L13-L14
• docs/platforms/php/index.mdx#L11-L12

 

[cursor]

Cursor Bugbot has reviewed your changes and found 2 potential issues.

^{Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

[cursor]

Dart platform incorrectly uses Flutter skill name

Medium Severity

The Dart platform page uses skill="sentry-flutter-sdk" which generates a prompt URL pointing to https://skills.sentry.gg/sentry-flutter-sdk/SKILL.md and install commands referencing the Flutter skill. Plain Dart (server-side) is a distinct SDK (sentry.dart) from Flutter (sentry.dart.flutter), so Dart users would receive Flutter-specific setup instructions that may not apply to their non-Flutter Dart application. The description says "set up Sentry in your Dart app" but the linked skill content is Flutter-specific.

 

[cursor]

Missing platformName on AI monitoring callout

Low Severity

The AI Agent Monitoring callout uses <AgentSkillsCallout skill="sentry-setup-ai-monitoring" /> without a platformName, so the description reads the generic "Your agent will set up Sentry automatically" instead of mentioning the specific platform context. The old Expandable mentioned "your application" explicitly. This is inconsistent with other JavaScript-section callouts and the Python AI monitoring page at docs/platforms/python/integrations/openai-agents/index.mdx which does pass platformName="Python".