Skip to main content
Las tareas de ingeniería más difíciles a menudo requieren algo más que buenos prompts. Pueden necesitar scripts de referencia, plantillas, lista de comprobación y otros archivo de apoyo. Las Skills te permiten agrupar todo esto en carpetas que Cascade puede invocar (leer y usar). Las Skills son una excelente forma de enseñar a Cascade cómo ejecutar flujos de trabajo de varios pasos de manera coherente. Cascade usa revelación progresiva: de forma predeterminada, al modelo de IA solo se le muestran el name y la description de la Skill. El contenido completo de SKILL.md y los archivo de apoyo se cargan solo cuando Cascade decide invocar la Skill (o cuando la mencionas con @). Esto mantiene tu ventana de contexto ligera incluso con muchas Skills definidas. Para más detalles sobre la especificación de Skills, visita agentskills.io.

​
Cómo crear una habilidad

​
Usando la interfaz (más fácil)

  1. Abre el panel de Cascade
  2. Haz clic en los tres puntos en la parte superior derecha del panel para abrir el menú de Customizations
  3. Haz clic en la sección Skills
  4. Haz clic en + Workspace para crear una Skill específica de un workspace (proyecto), o en + Global para crear una Skill global
  5. Asigna un nombre a la Skill (solo letras minúsculas, números y guiones)

​
Creación manual

Skill de workspace (específica del proyecto):
  1. Crea un directorio: .windsurf/skills/<skill-name>/
  2. Añade un archivo SKILL.md con frontmatter YAML
Skill global (disponible en todos los workspaces):
  1. Crea un directorio: ~/.codeium/windsurf/skills/<skill-name>/
  2. Añade un archivo SKILL.md con frontmatter YAML

​
Formato del archivo SKILL.md

Cada skill requiere un archivo SKILL.md con un frontmatter YAML que contiene los metadatos de dicha skill:

​
Ejemplo de skill

​
Campos obligatorios de frontmatter

  • name: Identificador único para la skill (se muestra en la UI y se usa para las menciones con @)
  • description: Breve explicación que se muestra al modelo de IA para que pueda decidir cuándo invocar la skill
Ejemplos de nombres válidos: deploy-to-staging, code-review, setup-dev-environment

​
Añadir recursos de apoyo

Coloca cualquier archivo de apoyo en la carpeta de la skill, junto a SKILL.md. Estos archivos estarán disponibles para Cascade cuando se invoque la skill:

​
Invocación de habilidades

​
Invocación automática

Cuando tu solicitud coincide con la descripción de una skill, Cascade invoca automáticamente esa skill y usa sus instrucciones y recursos para completar la tarea. Esta es la forma más habitual de usar las skills: simplemente describes lo que quieres hacer y Cascade determina qué skills son relevantes. El campo description en el frontmatter de tu skill es clave: ayuda a Cascade a entender cuándo debe invocar la skill. Escribe descripciones que expliquen claramente qué hace la skill y cuándo debe utilizarse.

​
Invocación manual

Siempre puedes activar explícitamente una skill escribiendo @skill-name en el campo de entrada de Cascade. Esto es útil si quieres asegurarte de que se use una skill específica o cuando quieres invocar una skill que podría no activarse automáticamente con tu solicitud.

​
Ámbitos de skills

Para la compatibilidad entre agentes, Windsurf también detecta skills en .agents/skills/ y ~/.agents/skills/. Si has habilitado la lectura de la configuración de Claude Code, también se escanean .claude/skills/ y ~/.claude/skills/.

​
Skills de nivel del sistema (Enterprise)

Las organizaciones Enterprise pueden implementar Skills que están disponibles en todos los workspaces y que los usuarios finales no pueden modificar: Cada Skill es un subdirectorio que contiene un archivo SKILL.md, al igual que las Skills del workspace.

​
Casos de uso de ejemplo

​
Flujo de despliegue

Crea una skill con scripts de despliegue, configuraciones de entorno y procedimientos de reversión:

​
Directrices de revisión de código

Incluye guías de estilo, listas de comprobación de seguridad y plantillas de revisión:

​
Procedimientos de prueba

Agrupa las plantillas de prueba, los requisitos de cobertura y la configuración de CI/CD:

​
Mejores prácticas

  1. Escribe descripciones claras: La descripción ayuda a Cascade a decidir cuándo debe invocar la skill. Sé específico acerca de lo que hace la skill y en qué casos debe utilizarse.
  2. Incluye recursos relevantes: Las plantillas, listas de comprobación y ejemplos hacen que las skills sean más útiles. Piensa en qué archivos podrían ayudar a alguien a completar la tarea.
  3. Usa nombres descriptivos: deploy-to-staging es mejor que deploy1. Los nombres deben indicar claramente lo que hace la skill.

​
Skills vs Rules vs Workflows

Los tres personalizan Cascade, pero difieren en estructura, invocación y costo de contexto: Regla general: si Cascade debe detectarlo automáticamente y necesita archivo de apoyo, usa un Skill. Si es una restricción breve de comportamiento, usa una Rule. Si siempre quieres activarlo tú mismo, usa un Workflow. Si Skills no es lo que buscas, consulta estas otras funciones de Cascade:
  • Workflows - Automatiza tareas repetitivas con flujos de trabajo reutilizables en Markdown, invocados mediante comandos con barra diagonal (/)
  • AGENTS.md - Proporciona instrucciones con alcance de directorio que se aplican automáticamente según la ubicación del archivo
  • Memories & Rules - Mantén el contexto entre conversaciones con memorias generadas automáticamente y reglas definidas por el usuario