GitHub - getsentry/skills: Agent Skills used by the Sentry team for development.
Extracto
Agent Skills used by the Sentry team for development. - getsentry/skills
Resumen
Resumen Principal
El documento detalla el sistema Sentry Skills, un conjunto de habilidades predefinidas diseñadas para estandarizar y optimizar las prácticas de ingeniería dentro de Sentry, siguiendo el formato abierto de Agent Skills. Este marco permite integrar pautas y procesos clave directamente en agentes de inteligencia artificial como Claude Code, así como en otros entornos de agentes. El objetivo principal es asegurar la consistencia en tareas críticas de desarrollo, como la revisión de código, la elaboración de mensajes de commit y la creación de pull requests, al mismo tiempo que se facilita la identificación de errores y vulnerabilidades de seguridad. La capacidad de instalar, actualizar y, crucialmente, crear nuevas habilidades personalizadas, subraya la flexibilidad del sistema para adaptarse a las necesidades evolutivas de Sentry, impulsando la eficiencia y la adherencia a sus estándares de calidad y seguridad. Este enfoque potencia la automatización inteligente en el ciclo de vida del desarrollo de software.
Elementos Clave
- Instalación y Gestión de Sentry Skills: El sistema Sentry Skills se integra fácilmente con Claude Code mediante el Marketplace de plugins (
marketplace add getsentry/skills) o a través de una clonación local del repositorio (git clone git@github.com:getsentry/skills.git). La instalación (claude plugin install) y las actualizaciones (claude plugin marketplace update,claude plugin update sentry-skills@sentry-skills) se gestionan mediante comandos Claude Code o un gestor interactivo, garantizando que los agentes siempre utilicen las versiones más recientes de las pautas. - Portafolio de Habilidades Disponibles: El conjunto actual de habilidades cubre aspectos fundamentales del desarrollo en Sentry. Incluye
code-review(pautas de revisión),commit(convenciones de mensajes de commit),create-pr(creación de pull requests),deslop(eliminación de "código chatarra" generado por IA),find-bugs(detección de errores y vulnerabilidades),iterate-pr(iteración en PRs hasta cumplir CI y feedback), yclaude-settings-audit(análisis de repositorio para configuración de Claude Code). - Marco para la Creación de Nuevas Habilidades: El sistema fomenta la extensión mediante la creación de nuevas habilidades personalizadas. Cada habilidad se define en un archivo
SKILL.mddentro de su propio directorio, siguiendo la especificación Agent Skills. Estos archivos incluyen un frontmatter YAML con campos obligatorios comoname(1-64 caracteres alfanuméricos en minúscula con guiones) ydescription(hasta 1024 caracteres con palabras clave de activación), así como secciones para instrucciones, ejemplos y pautas. - Extensibilidad y Compatibilidad con Otros Agentes: Aunque el enfoque principal es Claude Code, el formato abierto de Agent Skills permite que las Sentry Skills sean utilizadas por otros agentes. Esto se logra copiando el directorio
skills/a la ubicación designada por el agente o referenciando directamente los archivosSKILL.md, lo que subraya la naturaleza modular y la portabilidad del sistema más allá de un único entorno de IA.
Análisis e Implicaciones
Este sistema tiene implicaciones significativas para la consistencia en las prácticas de ingeniería de Sentry, permitiendo que la inteligencia artificial no solo automatice tareas, sino que también actúe como un guardián de los estándares de calidad y seguridad. Al codificar las directrices en habilidades de agente, Sentry está formalizando su conocimiento institucional y asegurando que sea aplicado de manera uniforme en todos los proyectos y por todos los desarrolladores.
Contexto Adicional
Sentry Skills representa un avance estratégico en la operacionalización de las prácticas de ingeniería de Sentry, integrando la automatización inteligente directamente en el flujo de trabajo de desarrollo para elevar la calidad del código y la eficiencia del equipo.
Contenido
Sentry Skills
Agent skills for Sentry employees, following the Agent Skills open format.
Installation
Claude Code (via Marketplace)
# Add the marketplace claude plugin marketplace add getsentry/skills # Install the plugin claude plugin install sentry-skills@sentry-skills
Claude Code (from local clone)
# Clone the repository git clone git@github.com:getsentry/skills.git ~/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
# 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 | Sentry code review guidelines and checklist |
| commit | Sentry commit message conventions |
| create-pr | Create pull requests following Sentry conventions |
| deslop | Remove AI-generated code slop from branch changes |
| find-bugs | Find bugs and security vulnerabilities in branch changes |
| iterate-pr | Iterate on a PR until CI passes and feedback is addressed |
| claude-settings-audit | Analyze repo and generate recommended Claude Code settings.json permissions |
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. 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:
--- 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 |
--- name: my-skill description: What this skill does license: Apache-2.0 model: sonnet allowed-tools: Read Grep Glob ---
References
License
Apache-2.0
Fuente: GitHub