Revisión de PRs
Checklist del equipo, criterios de seguridad y formato de feedback consistentes.
El agente no improvisa el estándar: sigue el de tu org.
portable · markdown · on-demand
Agent Skills
Procedimientos empaquetados en markdown que enseñan a un agente a hacer un trabajo concreto — y viajan con vos a cualquier herramienta compatible.
Una skill es una carpeta con un SKILL.md: instrucciones, ejemplos y (a veces) scripts. El agente las descubre por su description, las carga solo cuando hacen falta y las aplica como un playbook reutilizable.
Casos de uso
Para qué se usan las skills
No son “prompts sueltos”: son procedimientos reutilizables que el agente aplica cuando el trabajo encaja.
Mensajes de commit
Convenciones conventional-commits o el estilo del repo, generados desde el diff.
Menos ida y vuelta; más historial legible.
Workflows de deploy
Pasos frágiles (build, migrate, smoke) documentados una sola vez.
Ideal cuando el orden importa y el error es caro.
Conocimiento de dominio
APIs internas, schemas, jerga del producto y atajos que el modelo no conoce.
Convierte contexto local en capacidad portable.
Documentos y datos
PDF, Excel, formularios: cómo extraer, validar y reportar sin reinventar el script.
Scripts reutilizables + instrucciones claras.
Procedimientos internos
Onboarding, incidentes, releases: el mismo ritual en cada máquina y cada agente.
La skill es el runbook que el agente puede ejecutar.
Estructura
Anatomía de una skill
Una carpeta. Un SKILL.md obligatorio. El resto es progressive disclosure: detalle solo cuando hace falta.
my-skill/
SKILL.md
Cuándo se lee: Siempre. Es el corazón de la skill.
Frontmatter (name, description) + instrucciones principales. Idealmente bajo 500 líneas.
Frontmatter clave
name≤ 64 caracteresminúsculas, números y guiones; identificador único
description≤ 1024 caracterestercera persona; incluye WHAT (qué hace) y WHEN (cuándo usarla)
disable-model-invocationopcionaltrue = solo se carga si se nombra explícitamente
Anti-patterns
- Descripciones vagas (“ayuda con documentos”) sin triggers.
- SKILL.md de miles de líneas: todo pelea por espacio en el contexto.
- Rutas estilo Windows (scripts\helper.py) en lugar de scripts/helper.py.
- Demasiadas opciones sin un default claro.
- Información con fecha de caducidad hardcodeada en lugar de secciones “legacy”.
Contexto
Carga por niveles
La metadata siempre está; el cuerpo se lee al activarse; referencias y scripts solo si se necesitan.
Contexto aproximado12%
Por eso la description es crítica (siempre vive en el nivel 1) y el cuerpo de SKILL.md debería quedarse bajo ~500 líneas: el detalle caro va a referencias.
Exportar
El mismo SKILL.md, cualquier herramienta
Cambias la ruta de instalación. No reescribís el formato. Eso es lo que hace a las Agent Skills portables.
Disponible en todos tus proyectos de Cursor.
~/.cursor/skills/<skill-name>/
No uses
~/.cursor/skills-cursor/Reservado para skills internas de Cursor. No escribas skills de usuario ahí: el sistema las gestiona solo.
--- name: code-review description: Review code for quality, security and maintainability following team standards. Use when reviewing pull requests, examining code changes, or when the user asks for a code review. --- # Code Review ## Quick start 1. Check correctness and edge cases 2. Verify security basics 3. Assess readability 4. Ensure tests cover the change ## Feedback format - Critical: must fix before merge - Suggestion: consider improving - Nice to have: optional ## Additional resources - See [STANDARDS.md](STANDARDS.md)
--- a/SKILL.md +++ b/SKILL.md @@ (sin cambios) @@ # El formato Agent Skills no se reescribe. # Solo cambia dónde vive la carpeta.
Mapa mental
Skills vs Rules vs MCP vs Subagents
Tocá cada tarjeta para ver el reverso. Son piezas distintas del mismo sistema de agentes.
Preview Adviters
Catálogo real de skills
Snapshot del repo Adviters-Skills: buscá por stack, mirá dependsOn/relatedSkills y abrí el SKILL.md completo. dependsOn y relatedSkills son metadatos del catálogo/CLI, no nativos de Cursor.
Cargando catálogo…
Práctica
Validador de SKILL.md
Editá el frontmatter y el cuerpo. El puntaje estima qué tan descubrible y sana queda la skill.
100/100
Descubribilidad
name: code-review
líneas cuerpo: 16
- okname con formato válido.
- okdescription con WHAT + WHEN y longitud OK.
- okCuerpo con 16 líneas (bajo el umbral de 500).