---
title: "AI Agent Skills"
description: "Learn which skills to use, and when, to boost quality, consistency, and productivity across all Sentry SDKs."
url: https://develop.sentry.dev/sdk/getting-started/ai-tools/skills/
---

# AI Agent Skills

Agent skills teach AI coding agents how to perform specific workflows. Encode a workflow once in a skill and the agent loads it on demand. Skills live in a `skills/` directory inside your agent's config folder (e.g., `.claude/skills/`, `.cursor/skills/`) and follow the [Agent Skills open format](https://agentskills.io/specification).

## [Using Skills Safely](https://develop.sentry.dev/sdk/getting-started/ai-tools/skills.md#using-skills-safely)

##### Skills are a potential attack vector

Skills can inject packages or hide malicious instructions in HTML comments. Only install skills from [`getsentry/skills`](https://github.com/getsentry/skills), [`getsentry/sdk-skills`](https://github.com/getsentry/sdk-skills), or your own repo. Browsing [skills.sh](https://skills.sh/) to discover skills is fine — but do not enable auto-discovery or auto-install from it.

## [dotagents](https://develop.sentry.dev/sdk/getting-started/ai-tools/skills.md#dotagents)

[dotagents](https://github.com/getsentry/dotagents) is a package manager for `.agents` directories. Declare skill dependencies in `agents.toml`, lock exact versions in `agents.lock`, and dotagents symlinks them into wherever your coding agent looks. See the [dotagents docs](https://docs.sentry.io/ai/dotagents/) for full documentation including MCP server and hook configuration.

Use [dotagents.sentry.dev](https://dotagents.sentry.dev/) as the Sentry distribution hub — it's wired up to `getsentry/skills` and keeps everything in sync. The main `sentry` repository already has dotagents configured; use it to vend skills into SDK repos or manage personal-scope skills.

Commit `agents.toml` and `agents.lock` so every engineer on the team gets the same skills automatically.

| Command         | Description                                |
| --------------- | ------------------------------------------ |
| `init`          | Create `agents.toml` and `.agents/skills/` |
| `add <source>`  | Add a skill dependency                     |
| `remove <name>` | Remove a skill                             |
| `install`       | Install all skills from `agents.toml`      |
| `update [name]` | Update skills to latest versions           |
| `list`          | Show installed skills and their status     |
| `sync`          | Reconcile symlinks and verify state        |

## [Available Skills](https://develop.sentry.dev/sdk/getting-started/ai-tools/skills.md#available-skills)

### [Sentry Skills](https://develop.sentry.dev/sdk/getting-started/ai-tools/skills.md#sentry-skills)

Agent skills for Sentry employees, covering general workflows like committing, opening PRs, code review, finding bugs, and security review.

<https://github.com/getsentry/skills>

### [Sentry SDK Skills](https://develop.sentry.dev/sdk/getting-started/ai-tools/skills.md#sentry-sdk-skills)

Agent skills for managing feature development across Sentry SDKs — cross-SDK rollouts, Linear project setup, daily standups, and more.

<https://github.com/getsentry/sdk-skills>

### [Sentry for AI Skills](https://develop.sentry.dev/sdk/getting-started/ai-tools/skills.md#sentry-for-ai-skills)

Public skills for setting up Sentry in customer projects and debugging issues — SDK setup, AI monitoring configuration, issue fixing, and PR review workflows. See [Agent Skills](https://docs.sentry.io/ai/agent-skills/) for the full list and install instructions.

<https://github.com/getsentry/sentry-for-ai>

### [Sentry Reproduction Skill](https://develop.sentry.dev/sdk/getting-started/ai-tools/skills.md#sentry-reproduction-skill)

Generates minimal reproduction environments for SDK issues — reproducible test cases in isolated sandboxes for bug reporting, verification, and collaborative debugging.

<https://github.com/getsentry/repro>

### [Obra's Superpowers](https://develop.sentry.dev/sdk/getting-started/ai-tools/skills.md#obras-superpowers)

Structured software development workflows for AI agents: brainstorming, implementation planning, TDD, parallel execution, code review, and systematic debugging.

<https://github.com/obra/superpowers>

## [Contributing a Skill](https://develop.sentry.dev/sdk/getting-started/ai-tools/skills.md#contributing-a-skill)

If you find yourself explaining the same workflow to an agent repeatedly, formalize it as a skill. Skills follow the [Agent Skills specification](https://agentskills.io/specification):

```text
skill-name/
  SKILL.md        # YAML frontmatter (name, description) + markdown instructions
```

Add new skills to [`getsentry/skills`](https://github.com/getsentry/skills) (for general Sentry workflows) or [`getsentry/sdk-skills`](https://github.com/getsentry/sdk-skills) (for SDK-specific workflows) rather than a personal repo, so the whole team benefits.

For guidance on writing effective skills, see [Skill Synthesis](https://cra.mr/skill-synthesis) — using your own codebase's history, past failures, and real patterns as source material produces significantly better results than generic guidance.