AI Agent Skills
Learn which skills to use, and when, to boost quality, consistency, and productivity across all Sentry SDKs.
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.
Skills are a potential attack vector
Skills can inject packages or hide malicious instructions in HTML comments. Only install skills from getsentry/skills, getsentry/sdk-skills, or your own repo. Browsing skills.sh to discover skills is fine — but do not enable auto-discovery or auto-install from it.
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 for full documentation including MCP server and hook configuration.
Use 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 |
Agent skills for Sentry employees, covering general workflows like committing, opening PRs, code review, finding bugs, and security review.
https://github.com/getsentry/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
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 for the full list and install instructions.
https://github.com/getsentry/sentry-for-ai
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
Structured software development workflows for AI agents: brainstorming, implementation planning, TDD, parallel execution, code review, and systematic debugging.
https://github.com/obra/superpowers
If you find yourself explaining the same workflow to an agent repeatedly, formalize it as a skill. Skills follow the Agent Skills specification:
skill-name/
SKILL.md # YAML frontmatter (name, description) + markdown instructions
skill-name/
SKILL.md # YAML frontmatter (name, description) + markdown instructions
Add new skills to getsentry/skills (for general Sentry workflows) or 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 — using your own codebase's history, past failures, and real patterns as source material produces significantly better results than generic guidance.
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").