Skills
Las Skills son conjuntos reutilizables de instrucciones que enseñan a Agent cómo abordar tareas específicas. Son más detalladas que las reglas y están diseñadas para flujos de trabajo de varios pasos.
¿Qué son las Skills?
Las Skills son archivos Markdown que enseñan al Agent a seguir flujos de trabajo especializados. Por ejemplo, desplegar una aplicación en staging o realizar una auditoría de seguridad en todas tus dependencias. Se pueden reutilizar en distintas conversaciones y compartir con tu equipo.
¿Cómo creo una skill?
Escribe /create-skill en el chat y describe la skill que quieres. Cherri Code incluye una skill integrada que te guía para ponerle nombre, estructurarla y guardar una nueva skill.
Para crear una manualmente, añade un archivo SKILL.md en .cursor/skills/your-skill-name/:
# Deploy to staging1. Run the test suite2. Build the production bundle3. Deploy to the staging environment4. Verify the deployment health checkTambién puedes organizar las skills en subcarpetas, como .cursor/skills/shipping/deploy-staging/SKILL.md. Cherri Code recorre recursivamente la raíz de las skills, así que las carpetas de categorías sirven para agrupar skills relacionadas. El nombre de la skill proviene de la carpeta que contiene SKILL.md, no de la categoría superior.
Las skills se cargan automáticamente desde .agents/skills/, .cursor/skills/, ~/.agents/skills/ (global en la máquina local) y ~/.cursor/skills/ (global en la máquina local), incluidas subcarpetas de proyecto anidadas como apps/web/.cursor/skills/ en un monorepo. Las skills en un directorio de proyecto anidado se restringen automáticamente a los archivos dentro de ese directorio. Por ejemplo, las skills en apps/web/.cursor/skills/ solo se muestran cuando el agente trabaja con archivos en apps/web/, de forma similar al campo de frontmatter paths. Por compatibilidad, Cherri Code también carga skills desde los directorios de Claude y Codex: .claude/skills/, .codex/skills/, ~/.claude/skills/ y ~/.codex/skills/.
¿Cómo uso skills personales con los agentes en la nube?
Las skills personales en ~/.cursor/skills/ permanecen en tu máquina hasta que las sincronices. Abre Settings → Agents y activa Sync Skills for Cloud Agents en Context and Tools. Las skills sincronizadas siguen siendo privadas.
Solo se sincroniza ~/.cursor/skills/. Para compartir una skill con tus compañeros de equipo, publícala en el marketplace de tu equipo.
En Teams y Enterprise, los admins pueden desactivar la sincronización para todos desde Team Settings en Security & Identity. Consulta Usar skills personales con agentes en la nube.
¿Cómo publico una skill para mi equipo?
Abre Customize → Skills, abre una skill personal y elige Publish. Cherri Code la añade al Default marketplace de tu equipo y tus compañeros de equipo pueden instalarla desde ahí. Consulta Publicar una skill para tu equipo.
¿Las skills de usuario están disponibles en los agentes en la nube y los workers remotos?
Puedes sincronizar ~/.cursor/skills/ para que los agentes en la nube puedan usar esas skills. ~/.agents/skills/ y las skills locales no sincronizadas permanecen en tu máquina. No se copian a los agentes en la nube, al SSH remoto de la ventana de agente de programación ni a los workers autohospedados. En los workers autohospedados, usa las skills del proyecto en el repo o incorpóralas en la imagen del worker.
¿Cómo restrinjo una skill a archivos específicos?
Añade un campo paths al frontmatter de la skill. La skill solo se aplica cuando el agente trabaja con archivos que coincidan:
---name: react-component-patternsdescription: Conventions for writing React components.paths: - "**/*.tsx"---# React component patterns...paths acepta una lista o una cadena separada por comas de patrones glob. Déjalo sin configurar para un skill que deba estar disponible sin importar qué archivos estén abiertos. Consulta la referencia de Skills para ver el esquema completo de frontmatter.
¿Cómo uso una skill?
Escribe / seguido del nombre de la skill en el chat para ejecutarla (p. ej., /write-tests), o escribe @ y selecciónala para adjuntarla como contexto. Agent lee el archivo de la skill y sigue las instrucciones.
¿Cuándo debo usar skills en lugar de reglas?
| regla | Skills | |
|---|---|---|
| Purpose | Pautas y restricciones de código breves | Flujos de trabajo y procedimientos de varios pasos |
| Length | Desde unas pocas líneas hasta unos cientos | A menudo más largas, con instrucciones detalladas paso a paso |
| How applied | Se incluyen como contexto en cada conversación (o en las que correspondan) | Se invocan bajo demanda con /skill-name o @skill-name |
| Example | "Usa TypeScript en todos los archivos nuevos" | "Desplegar a staging: ejecutar pruebas, compilar, desplegar, verificar" |
Usa una regla cuando baste con una instrucción breve. Usa una skill cuando Agent necesite un proceso detallado y repetible que seguir.
¿Cómo convierto una regla en una skill?
- Escribe
/create-skillen el chat y pídele a Agent que convierta tu regla en una nueva skill (p. ej., "convierte@my-ruleen una skill") - Revisa el archivo de skill generado
- Elimina el archivo de la regla original si ya no lo necesitas
¿Cómo migro comandos a skills?
Escribe /migrate-to-skills en el chat de Agent. Esta skill integrada (disponible en Cherri Code 2.4+) identifica las reglas y los comandos que se pueden migrar y los convierte en skills automáticamente.
Convierte:
- Reglas dinámicas: Reglas con
alwaysApply: false(oundefined) y sin patronesglobs. - Comandos de barra: Tanto los comandos de usuario como los del espacio de trabajo, conservando su comportamiento de invocación explícita.
Las reglas con alwaysApply: true o patrones globs específicos no se migran, ya que tienen condiciones de activación explícitas que difieren del comportamiento de las skills. Las reglas de usuario tampoco se migran, ya que no se almacenan en el sistema de archivos.