https://github.com/getsentry/skills
Agent Skills used by the Sentry team for development.
https://github.com/getsentry/skills
tag-production
Last synced: 2 months ago
JSON representation
Agent Skills used by the Sentry team for development.
- Host: GitHub
- URL: https://github.com/getsentry/skills
- Owner: getsentry
- License: apache-2.0
- Created: 2026-01-05T22:41:55.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-01-20T20:23:02.000Z (3 months ago)
- Last Synced: 2026-01-21T03:51:13.602Z (2 months ago)
- Topics: tag-production
- Homepage:
- Size: 105 KB
- Stars: 130
- Watchers: 1
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
- fucking-awesome-python - sentry-skills - Python-focused engineering skills for code review, debugging, and backend workflows. (AI and Agents)
- awesome-python - sentry-skills - Python-focused engineering skills for code review, debugging, and backend workflows. (AI and Agents)
README
# Sentry Skills
Agent skills for Sentry employees, following the [Agent Skills](https://agentskills.io) open format.
## Installation
### Claude Code (via Marketplace)
```bash
# Add the marketplace
claude plugin marketplace add getsentry/skills
# Install the plugin
claude plugin install sentry-skills@sentry-skills
```
### Claude Code (from local clone)
```bash
# Clone the repository
git clone git@github.com:getsentry/skills.git ~/sentry-skills
# Install the marketplace from the local clone
claude plugin marketplace add ~/sentry-skills
# Install the plugin directly
claude plugin install sentry-skills
```
After installation, restart Claude Code. The skills will be automatically invoked when relevant to your task.
### Updating
```bash
# Update the marketplace index
claude plugin marketplace update
# Update the plugin
claude plugin update sentry-skills@sentry-skills
```
Or use `/plugin` to open the interactive plugin manager.
### Other Agents
Copy the `skills/` directory to your agent's skills location, or reference the SKILL.md files directly according to your agent's documentation.
## Available Skills
| Skill | Description |
|-------|-------------|
| [code-review](plugins/sentry-skills/skills/code-review/SKILL.md) | Sentry code review guidelines and checklist |
| [commit](plugins/sentry-skills/skills/commit/SKILL.md) | Sentry commit message conventions |
| [create-pr](plugins/sentry-skills/skills/create-pr/SKILL.md) | Create pull requests following Sentry conventions |
| [find-bugs](plugins/sentry-skills/skills/find-bugs/SKILL.md) | Find bugs and security vulnerabilities in branch changes |
| [iterate-pr](plugins/sentry-skills/skills/iterate-pr/SKILL.md) | Iterate on a PR until CI passes and feedback is addressed |
| [claude-settings-audit](plugins/sentry-skills/skills/claude-settings-audit/SKILL.md) | Analyze repo and generate recommended Claude Code settings.json permissions |
| [agents-md](plugins/sentry-skills/skills/agents-md/SKILL.md) | Maintain AGENTS.md with concise agent instructions |
| [brand-guidelines](plugins/sentry-skills/skills/brand-guidelines/SKILL.md) | Write copy following Sentry brand guidelines |
| [doc-coauthoring](plugins/sentry-skills/skills/doc-coauthoring/SKILL.md) | Structured workflow for co-authoring documentation, proposals, and specs |
## Available Subagents
| Subagent | Description |
|----------|-------------|
| [code-simplifier](plugins/sentry-skills/agents/code-simplifier.md) | Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality |
## Repository Structure
```
sentry-skills/
├── .claude-plugin/
│ └── marketplace.json # Marketplace manifest
├── plugins/
│ └── sentry-skills/
│ ├── .claude-plugin/
│ │ └── plugin.json # Plugin manifest
│ ├── agents/
│ │ └── code-simplifier.md
│ └── skills/
│ ├── code-review/
│ │ └── SKILL.md
│ └── commit/
│ └── SKILL.md
├── AGENTS.md # Agent-facing documentation
├── CLAUDE.md # Symlink to AGENTS.md
└── README.md # This file
```
## Creating New Skills
Skills follow the [Agent Skills specification](https://agentskills.io/specification). Each skill requires a `SKILL.md` file with YAML frontmatter.
### Skill Template
Create a new directory under `plugins/sentry-skills/skills/`:
```
plugins/sentry-skills/skills/my-skill/
└── SKILL.md
```
**SKILL.md format:**
```yaml
---
name: my-skill
description: A clear description of what this skill does and when to use it. Include keywords that help agents identify when this skill is relevant.
---
# My Skill Name
## Instructions
Step-by-step guidance for the agent.
## Examples
Concrete examples showing expected input/output.
## Guidelines
- Specific rules to follow
- Edge cases to handle
```
### 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) |
| `model` | Override model for this skill (e.g., `sonnet`, `opus`, `haiku`) |
| `allowed-tools` | Space-delimited 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
model: sonnet
allowed-tools: Read Grep Glob
---
```
## References
- [Agent Skills Specification](https://agentskills.io/specification)
- [Sentry Engineering Practices](https://develop.sentry.dev/engineering-practices/)
## License
Apache-2.0