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.
Usando la interfaz (más fácil)
- Abre el panel de Cascade
- Haz clic en los tres puntos en la parte superior derecha del panel para abrir el menú de Customizations
- Haz clic en la sección
Skills
- Haz clic en
+ Workspace para crear una Skill específica de un workspace (proyecto), o en + Global para crear una Skill global
- Asigna un nombre a la Skill (solo letras minúsculas, números y guiones)
Skill de workspace (específica del proyecto):
- Crea un directorio:
.windsurf/skills/<skill-name>/
- Añade un archivo
SKILL.md con frontmatter YAML
Skill global (disponible en todos los workspaces):
- Crea un directorio:
~/.codeium/windsurf/skills/<skill-name>/
- Añade un archivo
SKILL.md con frontmatter YAML
Cada skill requiere un archivo SKILL.md con un frontmatter YAML que contiene los metadatos de dicha skill:
---
name: deploy-to-production
description: Guides the deployment process to production with safety checks
---
## Pre-deployment Checklist
1. Run all tests
2. Check for uncommitted changes
3. Verify environment variables
## Deployment Steps
Follow these steps to deploy safely...
[Reference supporting files in this directory as needed]
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
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:
.windsurf/skills/deploy-to-production/
├── SKILL.md
├── deployment-checklist.md
├── rollback-procedure.md
└── config-template.yaml
Invocación de habilidades
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.
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.
| Ámbito | Ubicación | Disponibilidad |
|---|
| Workspace | .windsurf/skills/ | Solo para el workspace/proyecto actual. Se incluye con tu repositorio. |
| Global | ~/.codeium/windsurf/skills/ | Todos los workspaces/proyectos en tu máquina. No se incluye. |
| Sistema (Enterprise) | Específico del SO (ver abajo) | Todos los workspaces, implementados por TI. Solo lectura. |
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)
| OS | Path |
|---|
| macOS | /Library/Application Support/Windsurf/skills/ |
| Linux/WSL | /etc/windsurf/skills/ |
| Windows | C:\ProgramData\Windsurf\skills\ |
SKILL.md, al igual que las Skills del workspace.
Crea una skill con scripts de despliegue, configuraciones de entorno y procedimientos de reversión:
.windsurf/skills/deploy-staging/
├── SKILL.md
├── pre-deploy-checks.sh
├── environment-template.env
└── rollback-steps.md
Directrices de revisión de código
.windsurf/skills/code-review/
├── SKILL.md
├── style-guide.md
├── security-checklist.md
└── review-template.md
.windsurf/skills/run-tests/
├── SKILL.md
├── test-template.py
├── coverage-config.json
└── ci-workflow.yaml
-
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.
-
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.
-
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
| Skills | Rules | Workflows |
|---|
| Propósito | Procedimientos de varios pasos con archivo de apoyo | Pautas de comportamiento (“cómo comportarse”) | Plantillas de prompts para tareas repetibles |
| Estructura | Carpeta con SKILL.md + cualquier archivo de recursos | Un único archivo .md con frontmatter | Un único archivo .md |
| Invocación | El modelo decide (revelación progresiva) o @mention | always_on / glob / model_decision / manual | Solo manual mediante /slash-command |
| ¿En el prompt del sistema? | No — solo el nombre + la descripción hasta que se invoca | Depende del modo de activación | No — se lista como comando disponible |
| Ideal para | Despliegues, revisión de código y procedimientos de prueba que requieren scripts/plantillas | Estilo de código, convenciones del proyecto, restricciones | Runbooks de ejecución única que activas explícitamente |
- 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
