mirror of
https://github.com/getsentry/skills.git
synced 2026-09-14 20:00:03 +08:00
David Cramer
65aa458f2c
New skill that guides agents to create and maintain concise AGENTS.md documentation with CLAUDE.md as a symlink. Enforces minimal style with headers, bullets, and skill references instead of verbose prose. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
152 lines
4.4 KiB
Markdown
152 lines
4.4 KiB
Markdown
# 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 |
|
|
| [deslop](plugins/sentry-skills/skills/deslop/SKILL.md) | Remove AI-generated code slop from branch changes |
|
|
| [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 |
|
|
|
|
## Repository Structure
|
|
|
|
```
|
|
sentry-skills/
|
|
├── .claude-plugin/
|
|
│ └── marketplace.json # Marketplace manifest
|
|
├── plugins/
|
|
│ └── sentry-skills/
|
|
│ ├── .claude-plugin/
|
|
│ │ └── plugin.json # Plugin manifest
|
|
│ └── 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
|