Skip to content

feat: Redesign Agent Skills callout with copy-prompt UX #16684

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
HazAT merged 8 commits into from
Mar 7, 2026
Merged

feat: Redesign Agent Skills callout with copy-prompt UX #16684

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
a58328e
feat(agent-skills): redesign agent skills callout with copy-prompt UX
HazAT Mar 4, 2026
ac6293a
refactor(agent-skills): use CodeTabs/CodeBlock and next/link internally
HazAT Mar 5, 2026
b1696b5
feat(agent-skills): add callout to Apple, Android, React Native, Go, …
HazAT Mar 5, 2026
fe1e3de
chore(agent-skills): remove dead .bolt CSS class
HazAT Mar 6, 2026
dedce37
refactor(agent-skills): condense callout to single-line layout
HazAT Mar 6, 2026
c5d12e4
fix(agent-skills): hide callout on mobile viewports
HazAT Mar 6, 2026
b1724ba
feat(agent-skills): add callout to Dart and Flutter setup pages
HazAT Mar 6, 2026
d5e60ca
[getsentry/action-github-commit] Auto commit
getsantry[bot] Mar 6, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -106,3 +106,4 @@ yalc.lock
# Claude Code local files
.claude/settings.local.json
mise.toml
.yarn/install-state.gz
2 changes: 2 additions & 0 deletions docs/platforms/android/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ keywords:
- 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>
Expand Down
2 changes: 2 additions & 0 deletions docs/platforms/dart/common/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,8 @@ categories:
- server
---

<AgentSkillsCallout skill="sentry-flutter-sdk" platformName="Dart" />
Copy link
Copy Markdown
Contributor

@cursor cursor Bot Mar 6, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Fix in Cursor Fix in Web


On this page, we get you up and running with Sentry's Dart SDK.

<Alert>
Expand Down
2 changes: 2 additions & 0 deletions docs/platforms/dart/guides/flutter/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,8 @@ categories:
- desktop
---

<AgentSkillsCallout skill="sentry-flutter-sdk" platformName="Flutter" />

On this page, we get you up and running with Sentry's Flutter SDK.

<Alert>
Expand Down
18 changes: 1 addition & 17 deletions docs/platforms/dotnet/common/logs/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,23 +12,7 @@ notSupported:
- dotnet.xamarin
---

<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 .NET application.

### Install Skills

```bash {tabTitle: dotagents}
npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-dotnet-sdk
```

```bash {tabTitle: npx skills}
npx skills add getsentry/sentry-for-ai --skill sentry-dotnet-sdk
```

See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.

</Expandable>
<AgentSkillsCallout skill="sentry-dotnet-sdk" platformName=".NET" />

With Sentry Structured Logs, you can send text-based log information from your applications to Sentry. Once in Sentry, these logs can be viewed alongside relevant errors, searched by text-string, or searched using their individual attributes.

Expand Down
18 changes: 1 addition & 17 deletions docs/platforms/dotnet/common/metrics/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,23 +7,7 @@ sidebar_section: features
beta: true
---

<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 metrics in your .NET application.

### Install Skills

```bash {tabTitle: dotagents}
npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-dotnet-sdk
```

```bash {tabTitle: npx skills}
npx skills add getsentry/sentry-for-ai --skill sentry-dotnet-sdk
```

See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.

</Expandable>
<AgentSkillsCallout skill="sentry-dotnet-sdk" platformName=".NET" />

<Alert>
This feature is currently in open beta. Please reach out on
Expand Down
18 changes: 1 addition & 17 deletions docs/platforms/dotnet/common/tracing/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,23 +6,7 @@ sidebar_order: 3
sidebar_section: features
---

<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 tracing in your .NET application.

### Install Skills

```bash {tabTitle: dotagents}
npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-dotnet-sdk
```

```bash {tabTitle: npx skills}
npx skills add getsentry/sentry-for-ai --skill sentry-dotnet-sdk
```

See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.

</Expandable>
<AgentSkillsCallout skill="sentry-dotnet-sdk" platformName=".NET" />

With [tracing](/product/insights/overview/), Sentry tracks your software performance, measuring metrics like throughput and latency, and displaying the impact of errors across multiple systems. Sentry captures distributed traces consisting of transactions and spans, which measure individual services and individual operations within those services. Learn more about our model in [Distributed Tracing](/product/sentry-basics/tracing/distributed-tracing/).

Expand Down
2 changes: 2 additions & 0 deletions docs/platforms/go/common/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
<AgentSkillsCallout skill="sentry-go-sdk" platformName="Go" />

On this page, we get you up and running with Sentry's SDK. If you are using our previous Go SDK, you can access the <Link rel={`nofollow`} to={`/platforms/go/legacy-sdk/`}>legacy SDK</Link> documentation, until further notice.

<Alert level="info" title="Using a framework?">
Expand Down
20 changes: 2 additions & 18 deletions docs/platforms/javascript/common/ai-agent-monitoring/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,23 +31,7 @@ supported:

With <Link to="/ai/monitoring/agents/dashboard/">Sentry AI Agent Monitoring</Link>, you can monitor and debug your AI systems with full-stack context. You'll be able to track key insights like token usage, latency, tool usage, and error rates. AI Agent Monitoring data will be fully connected to your other Sentry data like logs, errors, and traces.

<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 AI Agent Monitoring in your application.

### Install Skills

```bash {tabTitle: dotagents}
npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-setup-ai-monitoring
```

```bash {tabTitle: npx skills}
npx skills add getsentry/sentry-for-ai --skill sentry-setup-ai-monitoring
```

See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.

</Expandable>
<AgentSkillsCallout skill="sentry-setup-ai-monitoring" />
Copy link
Copy Markdown
Contributor

@cursor cursor Bot Mar 6, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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".

Fix in Cursor Fix in Web


## Prerequisites

Expand Down Expand Up @@ -171,7 +155,7 @@ await openai.chat.completions.create({
// Both calls will have gen_ai.conversation.id: "conv_abc123"

// To unset it
Sentry.setConversationId(null);
Sentry.setConversationId(null);
```

</SplitSectionCode>
Expand Down
18 changes: 1 addition & 17 deletions docs/platforms/javascript/common/metrics/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,23 +10,7 @@ notSupported:
- javascript.capacitor
---

<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 metrics in your application.

### Install Skills

```bash {tabTitle: dotagents}
npx @sentry/dotagents add getsentry/sentry-for-ai --all
```

```bash {tabTitle: npx skills}
npx skills add getsentry/sentry-for-ai
```

See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.

</Expandable>
<AgentSkillsCallout />

With [Sentry Metrics](/product/explore/metrics/), you can send counters, gauges, and distributions from your applications to Sentry. Once in Sentry, these metrics can be viewed alongside relevant errors, and searched using their individual attributes.

Expand Down
18 changes: 1 addition & 17 deletions docs/platforms/javascript/common/tracing/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,23 +6,7 @@ sidebar_order: 6
sidebar_section: features
---

<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 tracing in your application.

### Install Skills

```bash {tabTitle: dotagents}
npx @sentry/dotagents add getsentry/sentry-for-ai --all
```

```bash {tabTitle: npx skills}
npx skills add getsentry/sentry-for-ai
```

See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.

</Expandable>
<AgentSkillsCallout />

With [tracing](/product/insights/overview/), Sentry automatically tracks your software performance across your application services, measuring metrics like throughput and latency, and displaying the impact of errors across multiple systems.

Expand Down
2 changes: 2 additions & 0 deletions docs/platforms/javascript/guides/nestjs/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,8 @@ categories:
- server-node
---

<AgentSkillsCallout skill="sentry-nestjs-sdk" platformName="Nest.js" />
Copy link
Copy Markdown
Contributor

@cursor cursor Bot Mar 6, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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)

Fix in Cursor Fix in Web


<PlatformContent includePath="getting-started-prerequisites" />

## Step 1: Install
Expand Down
18 changes: 1 addition & 17 deletions docs/platforms/javascript/guides/nextjs/logs/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,23 +7,7 @@ sidebar_section: features
new: true
---

<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 Skills

```bash {tabTitle: dotagents}
npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-nextjs-sdk
```

```bash {tabTitle: npx skills}
npx skills add getsentry/sentry-for-ai --skill sentry-nextjs-sdk
```

See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.

</Expandable>
<AgentSkillsCallout skill="sentry-nextjs-sdk" platformName="Next.js" />

Sentry Logs let you send structured log data from your Next.js application. Unlike traditional string-based logging, structured logs include queryable attributes that help you debug issues faster by filtering on specific users, orders, or any business context you include.

Expand Down
18 changes: 1 addition & 17 deletions docs/platforms/javascript/guides/nextjs/tracing/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,23 +6,7 @@ sidebar_order: 5
sidebar_section: features
---

<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 tracing in your Next.js application.

### Install Skills

```bash {tabTitle: dotagents}
npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-nextjs-sdk
```

```bash {tabTitle: npx skills}
npx skills add getsentry/sentry-for-ai --skill sentry-nextjs-sdk
```

See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.

</Expandable>
<AgentSkillsCallout skill="sentry-nextjs-sdk" platformName="Next.js" />

Tracing captures the timing and flow of requests through your Next.js application. Learn more about [tracing](/concepts/key-terms/tracing/) and how Sentry uses traces to track performance across services.

Expand Down
2 changes: 2 additions & 0 deletions docs/platforms/javascript/guides/svelte/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,8 @@ categories:
- browser
---

<AgentSkillsCallout skill="sentry-svelte-sdk" platformName="Svelte" />

<PlatformContent includePath="getting-started-prerequisites" />

<OnboardingSteps>
Expand Down
2 changes: 2 additions & 0 deletions docs/platforms/javascript/guides/sveltekit/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,8 @@ categories:
- server-node
---

<AgentSkillsCallout skill="sentry-svelte-sdk" platformName="SvelteKit" />
Comment thread
HazAT marked this conversation as resolved.

<PlatformContent includePath="getting-started-prerequisites" />

## Step 1: Install
Expand Down
2 changes: 2 additions & 0 deletions docs/platforms/php/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,8 @@ categories:
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
Expand Down
18 changes: 1 addition & 17 deletions docs/platforms/python/integrations/openai-agents/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,23 +12,7 @@ The support for **OpenAI Agents SDK** is in its beta phase. Please test locally
This integration connects Sentry with the [OpenAI Python SDK](https://openai.github.io/openai-agents-python/).
The integration has been confirmed to work with OpenAI Agents version 0.0.19.

<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 AI Agent Monitoring in your Python application.

### Install Skills

```bash {tabTitle: dotagents}
npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-setup-ai-monitoring
```

```bash {tabTitle: npx skills}
npx skills add getsentry/sentry-for-ai --skill sentry-setup-ai-monitoring
```

See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.

</Expandable>
<AgentSkillsCallout skill="sentry-setup-ai-monitoring" platformName="Python" />

Once you've installed this SDK, you can use [Sentry AI Agents Insights](https://sentry.io/orgredirect/organizations/:orgslug/insights/ai/agents/), a Sentry dashboard that helps you understand what's going on with your AI agents.

Expand Down
18 changes: 1 addition & 17 deletions docs/platforms/python/logs/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,23 +7,7 @@ sidebar_section: features
new: true
---

<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 Python application.

### Install Skills

```bash {tabTitle: dotagents}
npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-python-sdk
```

```bash {tabTitle: npx skills}
npx skills add getsentry/sentry-for-ai --skill sentry-python-sdk
```

See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.

</Expandable>
<AgentSkillsCallout skill="sentry-python-sdk" platformName="Python" />

With Sentry Structured Logs, you can send text-based log information from your applications to Sentry. Once in Sentry, these logs can be viewed alongside relevant errors, searched by text-string, or searched using their individual attributes.

Expand Down
18 changes: 1 addition & 17 deletions docs/platforms/python/metrics/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,23 +7,7 @@ sidebar_section: features
beta: true
---

<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 metrics in your Python application.

### Install Skills

```bash {tabTitle: dotagents}
npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-python-sdk
```

```bash {tabTitle: npx skills}
npx skills add getsentry/sentry-for-ai --skill sentry-python-sdk
```

See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.

</Expandable>
<AgentSkillsCallout skill="sentry-python-sdk" platformName="Python" />

<Alert>

Expand Down
18 changes: 1 addition & 17 deletions docs/platforms/python/tracing/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,23 +6,7 @@ sidebar_order: 6
sidebar_section: features
---

<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 tracing in your Python application.

### Install Skills

```bash {tabTitle: dotagents}
npx @sentry/dotagents add getsentry/sentry-for-ai --name sentry-python-sdk
```

```bash {tabTitle: npx skills}
npx skills add getsentry/sentry-for-ai --skill sentry-python-sdk
```

See the [full list of available skills](https://skills.sh/getsentry/sentry-for-ai) and [installation docs](/ai/agent-skills/) for more details.

</Expandable>
<AgentSkillsCallout skill="sentry-python-sdk" platformName="Python" />

## Prerequisites

Expand Down
Loading
Loading