Absortio

Email → Summary → Bookmark → Email

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), y claude-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.md dentro de su propio directorio, siguiendo la especificación Agent Skills. Estos archivos incluyen un frontmatter YAML con campos obligatorios como name (1-64 caracteres alfanuméricos en minúscula con guiones) y description (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 archivos SKILL.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