
sentry-skills
✓ Official★ 846Claude Code plugin · getsentry/skills · Apache-2.0
Sentry-specific agent skills for code review, commits, and more
28 skills · 2 sub-agents — installs as one unit
⌁ skills (50)
agents-md
🔥🔥🔥🔥✓ VerifiedCreate and maintain minimal, high-signal agent documentation under 60 lines. Enforces research-backed best practices for agent-facing docs; instruction quality degrades with length Requires three core sections: Package Manager, File-Scoped Commands (per-file test/lint/typecheck), and Commit Attribution with agent identity Analyzes project structure (lock files, linter configs, CI commands, monorepo indicators) to determine what belongs in the file Uses headers and bullets only; references...
Full instructions & audit →agents-md
🔥🔥🔥✓ VerifiedThis skill should be used when the user asks to "create AGENTS.md", "update AGENTS.md", "maintain agent docs", "set up CLAUDE.md", or needs to keep agent…
Full instructions & audit →blog-writing-guide
🔥🔥✓ VerifiedWrite, review, and improve blog posts for the Sentry engineering blog following Sentry's specific writing standards, voice, and quality bar. Use this skill…
Full instructions & audit →blog-writing-guide
🔥🔥✓ VerifiedWrite, review, and improve blog posts for the Sentry engineering blog following Sentry's specific writing standards, voice, and quality bar. Use this skill…
Full instructions & audit →brand-guidelines
🔥🔥✓ VerifiedWrite copy following Sentry brand guidelines. Use when writing UI text, error messages, empty states, onboarding flows, 404 pages, documentation, marketing…
Full instructions & audit →brand-guidelines
🔥🔥✓ VerifiedWrite copy following Sentry brand guidelines. Use when writing UI text, error messages, empty states, onboarding flows, 404 pages, documentation, marketing…
Full instructions & audit →claude-settings-audit
🔥🔥🔥✓ VerifiedAnalyze a repository to generate recommended Claude Code settings.json permissions. Use when setting up a new project, auditing existing settings, or…
Full instructions & audit →claude-settings-audit
🔥🔥🔥✓ VerifiedAnalyze a repository to generate recommended Claude Code settings.json permissions. Use when setting up a new project, auditing existing settings, or…
Full instructions & audit →code-review
🔥🔥🔥✓ VerifiedPerform code reviews following Sentry engineering practices. Use when reviewing pull requests, examining code changes, or providing feedback on code quality.…
Full instructions & audit →code-review
🔥🔥🔥🔥✓ VerifiedCode review framework following Sentry engineering practices for pull requests and code quality assessment. Covers six key problem areas: runtime errors, performance bottlenecks, side effects, backwards compatibility, ORM query issues, and security vulnerabilities Includes design assessment guidance for component interactions, architectural alignment, and requirement conflicts Requires appropriate test coverage across functional, integration, and end-to-end tests with verification of edge...
Full instructions & audit →code-simplifier
🔥🔥🔥✓ VerifiedSimplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Use when asked to "simplify code", "clean up…
Full instructions & audit →code-simplifier
🔥🔥🔥✓ VerifiedCode simplification and refactoring focused on clarity, consistency, and maintainability. Applies project-specific best practices from CLAUDE.md, including ES modules, explicit type annotations, and proper React patterns Eliminates unnecessary complexity through reduced nesting, clearer naming, and removal of redundant abstractions Avoids nested ternaries and overly compact solutions in favor of explicit, readable code structures Preserves all original functionality and behavior while...
Full instructions & audit →commit
🔥🔥🔥✓ VerifiedEnforces Sentry conventional commit format with proper types, scopes, and issue references. Requires feature branch creation before committing to main or master; uses the create-branch skill to manage branch workflow Supports 12 commit types (feat, fix, ref, perf, docs, test, build, ci, chore, style, meta, license) with clear subject line rules and footer patterns for issue references Includes Co-Authored-By attribution for AI-generated changes and handles breaking changes with explicit...
Full instructions & audit →commit
🔥🔥✓ VerifiedALWAYS use this skill when committing code changes — never commit directly without it. Creates commits following Sentry conventions with proper conventional…
Full instructions & audit →create-branch
🔥🔥✓ VerifiedCreate a git branch following Sentry naming conventions. Use when asked to "create a branch", "new branch", "start a branch", "make a branch", "switch to a new…
Full instructions & audit →create-branch
🔥🔥✓ VerifiedCreate a git branch following Sentry naming conventions. Use when asked to "create a branch", "new branch", "start a branch", "make a branch", "switch to a new…
Full instructions & audit →django-access-review
🔥🔥🔥🔥✓ VerifiedDjango access control and IDOR security review. Use when reviewing Django views, DRF viewsets, ORM queries, or any Python/Django code handling user…
Full instructions & audit →django-access-review
🔥🔥🔥🔥✓ VerifiedDjango access control and IDOR security review. Use when reviewing Django views, DRF viewsets, ORM queries, or any Python/Django code handling user…
Full instructions & audit →django-perf-review
🔥🔥🔥🔥✓ VerifiedDjango performance code review. Use when asked to "review Django performance", "find N+1 queries", "optimize Django", "check queryset performance", "database…
Full instructions & audit →django-perf-review
🔥🔥🔥🔥✓ VerifiedDjango performance code review. Use when asked to "review Django performance", "find N+1 queries", "optimize Django", "check queryset performance", "database…
Full instructions & audit →find-bugs
🔥🔥🔥🔥✓ VerifiedComprehensive code review identifying bugs, security vulnerabilities, and quality issues in branch changes. Executes a structured five-phase review process: gathering the complete diff, mapping attack surfaces, running a detailed security checklist, verifying findings, and auditing coverage before conclusions Security checklist covers 11 critical areas including injection, XSS, authentication, authorization, CSRF, race conditions, session management, cryptography, information disclosure,...
Full instructions & audit →find-bugs
🔥🔥🔥✓ VerifiedFind bugs, security vulnerabilities, and code quality issues in local branch changes. Use when asked to review changes, find bugs, security review, or audit…
Full instructions & audit →gh-review-requests
🔥🔥🔥✓ VerifiedFetch unread GitHub notifications for open PRs where review is requested from a specified team or opened by a team member. Use when asked to "find PRs I need…
Full instructions & audit →gh-review-requests
🔥🔥🔥✓ VerifiedFetch unread GitHub notifications for open PRs where review is requested from a specified team or opened by a team member. Use when asked to "find PRs I need…
Full instructions & audit →gha-security-review
🔥🔥🔥🔥✓ VerifiedGitHub Actions security review for workflow exploitation vulnerabilities. Use when asked to "review GitHub Actions", "audit workflows", "check CI security",…
Full instructions & audit →gha-security-review
🔥🔥🔥🔥✓ VerifiedGitHub Actions security review for workflow exploitation vulnerabilities. Use when asked to "review GitHub Actions", "audit workflows", "check CI security",…
Full instructions & audit →iterate-pr
🔥🔥🔥✓ VerifiedIterate on a PR until CI passes. Use when you need to fix CI failures, address review feedback, or continuously push fixes until all checks are green.…
Full instructions & audit →iterate-pr
🔥🔥🔥✓ VerifiedIterate on a PR until CI passes. Use when you need to fix CI failures, address review feedback, or continuously push fixes until all checks are green.…
Full instructions & audit →pr-writer
🔥🔥🔥✓ VerifiedCreate and update pull requests following Sentry conventions. Use when opening a PR or refreshing an existing PR after material changes.
Full instructions & audit →pr-writer
🔥🔥🔥✓ VerifiedCreate and update pull requests following Sentry conventions. Use when opening a PR or refreshing an existing PR after material changes.
Full instructions & audit →presentation-creator
🔥🔥🔥✓ VerifiedCreate data-driven presentation slides using React, Vite, and Recharts with Sentry branding. Use when asked to "create a presentation", "build slides", "make a…
Full instructions & audit →presentation-creator
🔥🔥🔥✓ VerifiedCreate data-driven presentation slides using React, Vite, and Recharts with Sentry branding. Use when asked to "create a presentation", "build slides", "make a…
Full instructions & audit →prompt-optimizer
🔥🔥🔥🔥✓ VerifiedCreate, optimize, and iteratively refine agent prompts and system prompts. Use when asked to "improve a prompt", "optimize a system prompt", "rewrite an agent…
Full instructions & audit →prompt-optimizer
🔥🔥🔥✓ VerifiedCreates, optimizes, and iteratively refines agent prompts, system prompts, developer prompts, and reusable prompt templates. Use when asked to improve a…
Full instructions & audit →replay-ux-research
🔥🔥🔥✓ VerifiedAnalyze Sentry session replays to surface UX patterns, pain points, and user journeys for a given product area. Use when asked to "show me how users use", "day…
Full instructions & audit →replay-ux-research
🔥🔥✓ VerifiedAnalyze Sentry session replays to surface UX patterns, pain points, and user journeys for a given product area. Use when asked to "show me how users use", "day…
Full instructions & audit →security-review
🔥🔥🔥🔥✓ VerifiedSecurity code review for vulnerabilities. Use when asked to "security review", "find vulnerabilities", "check for security issues", "audit security", "OWASP…
Full instructions & audit →security-review
🔥🔥🔥🔥✓ VerifiedSystematic security code review identifying high-confidence vulnerabilities with data-flow verification. Focuses exclusively on HIGH CONFIDENCE findings: vulnerable patterns with confirmed attacker-controlled input, skipping theoretical issues and framework-mitigated code Requires codebase research before reporting: traces data flow, checks for validation/sanitization, and verifies exploitability rather than pattern-matching alone Covers 14 vulnerability categories (injection, XSS,...
Full instructions & audit →skill-scanner
🔥🔥🔥🔥✓ VerifiedAutomated security scanning for agent skills before installation, detecting prompt injection, malicious code, excessive permissions, and supply chain risks. Runs static analysis via bundled Python scanner that outputs structured JSON findings with severity levels and URLs Validates SKILL.md frontmatter (required fields, tool justification, model overrides) and checks for config poisoning or scope creep in instructions Analyzes scripts for data exfiltration, reverse shells, credential theft,...
Full instructions & audit →skill-scanner
🔥🔥🔥🔥✓ VerifiedScan agent skills for security issues. Use when asked to "scan a skill",
Full instructions & audit →skill-writer
🔥🔥🔥✓ VerifiedCreate, synthesize, and iteratively improve agent skills following the Agent Skills specification. Use when asked to "create a skill", "write a skill",…
Full instructions & audit →skill-writer
🔥🔥🔥✓ VerifiedCreate, synthesize, and iteratively improve agent skills following the Agent Skills specification. Use when asked to "create a skill", "write a skill",…
Full instructions & audit →sred-project-organizer
🔥✓ VerifiedTake a list of projects and their related documentation, and organize them into the SRED format for submission.
Full instructions & audit →sred-project-organizer
🔥🔥✓ VerifiedTake a list of projects and their related documentation, and organize them into the SRED format for submission.
Full instructions & audit →sred-work-summary
🔥✓ VerifiedGo back through the previous year of work and create a Notion doc that groups relevant links into projects that can then be documented as SRED projects.
Full instructions & audit →sred-work-summary
🔥🔥✓ VerifiedGo back through the previous year of work and create a Notion doc that groups relevant links into projects that can then be documented as SRED projects.
Full instructions & audit →typing-exclusion-worker
🔥🔥✓ VerifiedPython typing exclusion worker: remove assigned mypy exclusion modules in small scoped batches, fix typing issues, run validation, and produce a structured…
Full instructions & audit →typing-exclusion-worker
🔥🔥✓ VerifiedPython typing exclusion worker: remove assigned mypy exclusion modules in small scoped batches, fix typing issues, run validation, and produce a structured…
Full instructions & audit →⌁ sub-agents (2)
Sentry Skills
[!NOTE] For skills to help set up Sentry in your project or debug production issues, see https://github.com/getsentry/sentry-for-ai
Agent skills for Sentry employees, following the Agent Skills open format.
Available Skills
| Skill | Description |
|---|---|
| agents-md | Create and maintain concise, reference-backed AGENTS.md and CLAUDE.md files. |
| blog-writing-guide | Write, review, and improve blog posts for the Sentry engineering blog following Sentry's specific writing standards, voice, and quality bar. |
| brand-guidelines | Write copy following Sentry brand guidelines. |
| claude-settings-audit | Analyze a repository to generate recommended Claude Code settings.json permissions. |
| code-review | Perform code reviews following Sentry engineering practices. |
| code-simplifier | Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. |
| commit | ALWAYS use this skill when committing code changes — never commit directly without it. |
| create-branch | Create git branches following Sentry naming conventions. |
| django-access-review | Django access control and IDOR security review. |
| django-perf-review | Django performance code review. |
| doc-coauthoring | Guide users through a structured workflow for co-authoring documentation. |
| document-api-endpoint | Document and type a Sentry API endpoint with drf-spectacular OpenAPI schema — write/fix @extend_schema, specify response TypedDicts, type parameters, fix type drift, and promote to PUBLIC. |
| find-bugs | Find bugs, security vulnerabilities, and code quality issues in local branch changes. |
| gh-review-requests | Fetch unread GitHub notifications for open PRs where review is requested from a specified team or opened by a team member. |
| gha-security-review | GitHub Actions security review for workflow exploitation vulnerabilities. |
| iterate-pr | Iterate on a PR until CI passes and actionable review feedback is addressed. |
| presentation-creator | Create data-driven presentation slides using React, Vite, and Recharts with Sentry branding. |
| pr-link-issue | Append a GitHub issue link and its Linear ticket to the current PR's description. |
| pr-writer | Create, refresh, and rewrite pull request titles and descriptions following Sentry conventions. |
| prompt-optimizer | Optimize prompts with evals, model-family adapters, and exact external context references. |
| replay-ux-research | Analyze Sentry session replays to surface UX patterns, pain points, and user journeys for a given product area. |
| security-review | Security code review for vulnerabilities. |
| skill-scanner | Scan agent skills for security issues. |
| skill-writer | Canonical workflow to synthesize, create, and iteratively improve agent skills for this repository. |
| sred-project-organizer | Take a list of projects and their related documentation, and organize them into the SRED format for submission. |
| sred-work-summary | Go back through the previous year of work and create a Notion doc that groups relevant links into projects that can then be documented as SRED projects. |
| triage-frontend-issues | Triage the Sentry javascript project queue by archiving non-actionable noise (third-party libs, browser quirks, transient 5xx, test traffic) with untilEscalating after user approval. |
| typing-exclusion-worker | Python typing exclusion worker: remove assigned mypy exclusion modules in small scoped batches, fix typing issues, run validation, and produce a structured completion summary. |
Available Subagents
| Subagent | Description |
|---|---|
| code-simplifier | Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality |
| senpai | Senior engineer and technical mentor for new Sentry hires. Explains infrastructure, architecture, and engineering concepts step-by-step with references |
Instructions
Step-by-step guidance for the agent.
Examples
Concrete examples showing expected input/output.
Guidelines
- Specific rules to follow
- Edge cases to handle
**SPEC.md format:**
Use `SPEC.md` as the maintenance contract for the skill. It should describe intent, scope, trigger context, source/evidence model, reference architecture, evaluation expectations, known limitations, and maintenance notes. Keep runtime instructions in `SKILL.md`; keep source inventories in `SOURCES.md`; keep durable examples in `references/evidence/`.
#### Naming Conventions
- **name**: 1-64 characters, lowercase alphanumeric with hyphens only
- **description**: Up to 1024 characters, include trigger keywords
- Keep SKILL.md under 500 lines; split longer content into reference files
#### Optional Fields
| Field | Description |
|-------|-------------|
| `license` | License name or path to license file |
| `compatibility` | Environment requirements (max 500 chars) |
| `allowed-tools` | Comma-separated list of tools the skill can use |
| `metadata` | Arbitrary key-value pairs for additional properties |
```yaml
---
name: my-skill
description: What this skill does
license: Apache-2.0
allowed-tools: Read, Grep, Glob
---Where Skills Belong
Skills should live in the appropriate location based on their scope:
| Scope | Location | Example |
|---|---|---|
| Global - Used across Sentry | sentry-skills plugin | commit, code-review, pr-writer |
| Domain-specific - Used by a team or domain | Dedicated plugin in this repo (e.g., infra-skills) | gcp-logs, terraform-review |
| Repo-specific - Only relevant to one repo | The repository itself (.claude/skills/) | Project-specific workflows |
When deciding where to place a skill:
- If most Sentry engineers would benefit, add it to
sentry-skills - If only a specific team needs it, create or use a domain-specific plugin
- If it only makes sense in one repo, keep it in that repo
Marketplace Structure
This repository is a Claude Code marketplace - a collection of plugins that can be installed independently. The marketplace manifest (.claude-plugin/marketplace.json) lists all available plugins:
{
"plugins": [
{
"name": "sentry-skills",
"source": "./"
},
{ "name": "infra-skills", "source": "./plugins/infra-skills" }
]
}Marketplace entries point at a plugin source directory. That source can be a dedicated plugin directory with its own .claude-plugin/plugin.json, or repo root when the root also carries a plugin manifest. The sentry-skills entry in this repo uses repo root as its plugin source so it can keep canonical skills/ and agents/ at top level.
Users can install individual plugins:
# Install just the global skills
claude plugin install sentry-skills@sentry-skills
# Install domain-specific skills
claude plugin install infra-skills@sentry-skillsTo add a new domain-specific plugin:
- Create
plugins/<plugin-name>/.claude-plugin/plugin.json - Add skills under
plugins/<plugin-name>/skills/ - Register the plugin in
.claude-plugin/marketplace.json
Vendoring Skills
We vendor (copy) skills and agents that we use regularly into this repository rather than depending on external sources at runtime. This approach:
- Ensures consistency - Everyone on the team uses the same version of each skill
- Enables customization - We can adapt skills to Sentry-specific conventions
- Improves reliability - No external dependencies that could change or disappear
Attribution
When vendoring a skill or agent from an external source, retain proper attribution:
-
Add a comment at the top of the file referencing the original source:
<!-- Based on [Original Name] by [Author/Org]: https://github.com/example/original-source --> -
Include a LICENSE file in the skill directory if the original has specific licensing requirements:
skills/vendored-skill/ ├── SKILL.md └── LICENSE # Original license text
Example: code-simplifier
The code-simplifier agent is vendored from Anthropic's official plugins. See the attribution comment at the top of the agent file.
References
Installation
Claude Code
claude plugin marketplace add getsentry/skills
claude plugin install sentry-skills@sentry-skillsIf you use claude plugin marketplace add --sparse for this repo, include skills and agents alongside .claude-plugin because the root plugin manifest loads repo-root skills/ and agents/.
Restart Claude Code after installation. Skills activate automatically when relevant.
Update:
claude plugin marketplace update
claude plugin update sentry-skills@sentry-skillsOr run /plugin to open the plugin manager.
Skills Package (skills.sh)
For agents supporting the skills.sh ecosystem:
npx skills add getsentry/skillsWorks with Claude Code, Cursor, Cline, GitHub Copilot, and other compatible agents.
One install gets you everything — 28 skills, 2 sub-agents — kept up to date together.
Licensed under Apache-2.0— you can use, modify, and redistribute it under that license's terms.
License
Apache-2.0