Ir al contenido principal
Español— Elegir un idioma
Menú

Crear una habilidad con SKILL.md

Lección 6 de 14 Actualizado el 2 de noviembre de 2026 Avanzado
En esta página
  1. Habilidades: Componentes reutilizables
  2. Anatomía de un SKILL.md
  3. Los campos del frontmatter YAML
  4. El cuerpo de SKILL.md
  5. Crea tu primera habilidad
  6. Buenas prácticas
  7. Puntos clave

Lección actualizada el 2 de noviembre de 2026 según la página Skills de la documentación de Vibe: una habilidad es un conjunto de instrucciones (no añade herramientas), allowed-tools se lee pero no se aplica, y se han añadido dos campos (disable-model-invocation, compatibility). Fuente: Skills.

Habilidades: Componentes reutilizables

Los agentes definen quién ejecuta una tarea. Las habilidades definen qué: son conjuntos de instrucciones reutilizables que añaden procedimientos y comandos de barra (/) a Mistral Vibe. La distinción se vuelve concreta al aplicarla a tu equipo: un agente refleja una postura de trabajo personal, mientras que una habilidad encapsula un procedimiento que todos deben ejecutar de la misma manera.

Una habilidad es un directorio que contiene un archivo SKILL.md con un frontmatter en YAML. Esta estructura sigue la especificación abierta Agent Skills, lo que hace que las habilidades sean portátiles y compartibles: la misma carpeta funciona en el ordenador de tu colega sin necesidad de adaptación.

Anatomía de un SKILL.md

Aquí tienes la estructura completa de una habilidad, ilustrada con un ejemplo de revisión de código automatizada:

---
name: code-review
description: Performs automated code reviews with quality analysis
license: MIT
user-invocable: true
allowed-tools:
  - read_file
  - grep
  - ask_user_question
---

# Code Review Skill

This skill analyzes source code quality by checking:

1. **Naming conventions** — variables, functions, classes
2. **Cyclomatic complexity** — functions that are too long or nested
3. **Duplication** — copy-pasted code to refactor
4. **Security** — dangerous patterns (eval, SQL injection, XSS)

## Usage

Run `/code-review` followed by the path or description of the code to analyze.

## Output format

The report is structured in three levels:
- 🔴 **Critical** — fix immediately
- 🟡 **Warning** — fix before merging
- 🟢 **Suggestion** — optional improvement

Los campos del frontmatter YAML

El campo name es el identificador único de la habilidad. Se utiliza para activar, desactivar y referenciar la habilidad en las configuraciones. Este nombre se convierte también en el comando de barra (/), por lo que merece la pena mantenerlo corto.

name: code-review

El campo description, de hasta 1.024 caracteres, es la frase que aparece cuando Vibe lista las habilidades disponibles. Escríbela desde la perspectiva de alguien que busca: debe permitirle elegir entre dos habilidades similares sin necesidad de abrir los archivos.

description: Performs automated code reviews with quality analysis

El campo license indica la licencia de la habilidad, algo que cobra importancia en cuanto la compartes más allá de tu propia estación de trabajo.

license: MIT

El booleano user-invocable, verdadero por defecto, expone la habilidad como un comando de barra (/). Establécelo en false para ocultarla del menú /: el agente podrá seguirla cargando automáticamente cuando la tarea lo requiera.

user-invocable: true   # Accessible via /code-review
user-invocable: false  # Hidden from / menu, agent can still load it

El campo disable-model-invocation, cuando se establece en true, impide que el agente cargue la habilidad por su cuenta: solo se ejecuta si escribes /skill-name. Reserva esto para procedimientos que ningún modelo debería desencadenar sin tu consentimiento explícito, como un despliegue.

disable-model-invocation: true

Dos campos informativos completan la lista: compatibility, que anota los prerrequisitos («Requires git»), y allowed-tools, que enumera las herramientas que la habilidad intenta usar. Ten cuidado con este último: la documentación especifica que Vibe lo lee pero no lo aplica. Una habilidad puede llamar a cualquier herramienta que el agente activo autorice. Para limitar lo que una habilidad puede hacer, restringe las herramientas y permisos del agente (lecciones 2 y 3).

allowed-tools:
  - read_file
  - grep
  - ask_user_question

El cuerpo de SKILL.md

Tras el frontmatter, el cuerpo del archivo es Markdown de formato libre. Sirve tanto de documentación como de prompt: Vibe lo lee para entender cómo funciona la habilidad y en qué contexto aplicarla. Aquí es donde describes qué hace la habilidad, los pasos de su funcionamiento, el formato de salida esperado y ejemplos de uso. Un cuerpo vago genera una habilidad impredecible; un cuerpo preciso genera una habilidad que produce el mismo resultado semana tras semana.

Crea tu primera habilidad

Vamos a construir una habilidad de generación de pruebas. Empieza creando su directorio:

mkdir -p ~/.vibe/skills/test-generator

Coloca el siguiente SKILL.md en su interior. Observa cómo el cuerpo responde a preguntas que, de otro modo, Vibe tendría que adivinar: qué framework elegir, cómo nombrar los bloques, dónde escribir el archivo de salida.

---
name: test-generator
description: Generates unit tests for TypeScript/JavaScript functions
license: MIT
user-invocable: true
allowed-tools:
  - read_file
  - write_file
  - grep
---

# Test Generator

Generates comprehensive unit tests for
TypeScript and JavaScript functions.

## Process

1. Read the target source file
2. Identify all exported functions
3. For each function, generate:
   - Happy path test
   - Test with empty/null inputs
   - Edge case tests
   - Expected error tests
4. Write tests to an adjacent `.test.ts` file

## Conventions

- Framework: Vitest (default) or Jest if detected
- Naming: `describe` per function, `it` per test case
- Assertions: `expect` with precise matchers
- No mocks unless necessary (external dependencies)

## Example

For a file `utils/math.ts` containing `add(a, b)`,
the skill generates `utils/math.test.ts` with corresponding tests.

Una vez creado el archivo, la habilidad está disponible de inmediato: sin comandos de instalación, sin reinicios. Lanza Vibe y llámala sobre un archivo real.

vibe
# > /test-generator src/utils/math.ts

Vibe carga la habilidad, lee su SKILL.md para entender el comportamiento esperado y ejecuta la tarea con las herramientas autorizadas. Tómate tu tiempo para leer el resultado: comparando la salida con lo que imaginabas, refinarás el cuerpo del archivo.

Buenas prácticas

Limítate a una habilidad por funcionalidad. Mezclar la revisión de código y la generación de pruebas en un único archivo produce un prompt ambiguo y te impide desactivar una sin perder la otra. Del mismo modo, limita las herramientas autorizadas a aquellas que la habilidad necesita realmente.

El resto depende de la calidad de la redacción. El cuerpo del SKILL.md es tu prompt: sé preciso e incluye ejemplos concretos de lo que produce la habilidad; un ejemplo de salida vale más que tres líneas de descripción. Por último, prueba tu habilidad en varios casos, incluido uno espinoso, antes de compartirla con el equipo.

Puntos clave

  • Una habilidad es un directorio con un archivo SKILL.md que contiene un frontmatter en YAML
  • El frontmatter define el nombre, la descripción, las herramientas permitidas y la capacidad de invocación
  • El cuerpo en Markdown sirve tanto de documentación como de prompt para Vibe
  • user-invocable: true hace que la habilidad sea accesible mediante un comando de barra (/)
  • Crea habilidades especializadas con el mínimo de herramientas necesarias