# Skills (/es/docs/verdent-manager/core-features/skills)
> Amplía las capacidades de Verdent con paquetes de conocimiento reutilizables para flujos de trabajo especializados y experiencia de dominio
Las **Skills** de Verdent son paquetes de conocimiento reutilizables que amplían la experiencia del agente. Cada Skill contiene prompts específicos de dominio, scripts, referencias y mejores prácticas. Solo tienes que invocar una Skill por su nombre, y el agente carga el contexto correspondiente y sigue el flujo de trabajo predefinido.
***
## ¿Qué son las Skills? [#qué-son-las-skills]
### Concepto principal [#concepto-principal]
Una **Skill** es un paquete de conocimiento estructurado almacenado en una carpeta. Cada Skill contiene un archivo `SKILL.md` que define su nombre, su descripción y su prompt detallado. Cuando invocas una Skill en una conversación, Verdent lee este archivo e inyecta su contenido en el contexto del agente.
### En qué se diferencian las Skills de los subagentes y MCP [#en-qué-se-diferencian-las-skills-de-los-subagentes-y-mcp]
| Dimensión | Skills | Subagentes | MCP |
| ------------------ | ------------------------------------------------------------- | --------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| **Activación** | Invocación manual mediante `@skill` o mención | Generados automáticamente por el agente principal | Invocados automáticamente o llamados de forma explícita |
| **Ejecución** | Amplía el contexto de la conversación principal | Se ejecuta como una subtarea independiente con contexto aislado | Llama a herramientas externas mediante JSON-RPC 2.0 |
| **Propósito** | Orientación de dominio (por ejemplo, "cómo escribir pruebas") | Operaciones independientes (por ejemplo, "ejecutar una revisión de código") | Acceso a datos o herramientas externas (por ejemplo, consultas a bases de datos) |
| **Ciclo de vida** | Inyección de contexto única | Completa la subtarea y luego devuelve los resultados | Proceso de servidor persistente durante la sesión |
| **Implementación** | Archivos Markdown + scripts opcionales | Lógica integrada del agente | Procesos de servidor ejecutables |
En resumen: **las Skills aportan conocimiento y orientación de flujo de trabajo**, **los subagentes ejecutan tareas independientes** y **MCP conecta herramientas y fuentes de datos externas**.
***
## Cómo usar las Skills [#cómo-usar-las-skills]
### Invocar una Skill [#invocar-una-skill]
Puedes invocar una Skill de dos maneras:
**1. Menciona el nombre de la Skill en la conversación**
```
Use the skill-creator skill to help me create a new Skill
```
**2. Usa la sintaxis de mención con @**
```
@skill-creator help me create a Skill for API documentation generation
```
Cuando se activa una Skill:
1. El agente llama a la herramienta `skill` para leer el archivo `SKILL.md` de la Skill
2. El contenido del archivo se inyecta en el contexto de la conversación actual
3. El agente continúa trabajando según la orientación de la Skill
### Explorar las Skills disponibles [#explorar-las-skills-disponibles]
Accede al panel de Skills a través de Settings:
1. Abre el menú **Settings**
2. Selecciona la pestaña **Skills**
3. Explora las Skills instaladas y las Skills disponibles en el Skill Store
También puedes escribir `@` en el cuadro de entrada para activar el autocompletado y seleccionar rápidamente una Skill disponible.
***
## Skills integradas [#skills-integradas]
Verdent incluye un conjunto de Skills integradas que cubren flujos de trabajo comunes:
| Skill | Descripción |
| ------------------- | ---------------------------------------------------------------------------------------------- |
| **docx** | Lee, crea o edita documentos de Word (`.docx`) con verificaciones visuales fieles al formato |
| **find-skills** | Descubre e instala Skills: úsala cuando preguntes "¿cómo hago X?" o busques nuevas capacidades |
| **frontend-design** | Crea interfaces de frontend distintivas y de calidad de producción con un alto nivel de diseño |
| **pdf** | Lee, crea o revisa archivos PDF con renderizado visual y extracción de contenido |
| **pptx** | Lee, crea o edita presentaciones de PowerPoint (`.pptx`) |
| **skill-creator** | Un flujo de trabajo guiado para crear e iterar sobre Skills personalizadas |
| **xlsx** | Lee, analiza, visualiza y edita de forma inteligente hojas de cálculo de Excel |
Hay más Skills disponibles en el **Skill Store**. Abre **Settings → Skills → Store** para explorar e instalar Skills adicionales.
***
## Crear Skills personalizadas [#crear-skills-personalizadas]
Puedes crear Skills personalizadas para encapsular la experiencia de dominio de tu equipo o los flujos de trabajo específicos de tu proyecto.
### Estructura del directorio de una Skill [#estructura-del-directorio-de-una-skill]
Una carpeta de Skill estándar tiene este aspecto:
```
my-custom-skill/
├── SKILL.md # Required: Skill definition file
├── agents/
│ └── verdent.yaml # Optional: UI configuration (icons, display name)
├── scripts/ # Optional: helper scripts
└── references/ # Optional: reference docs or examples
```
### Formato de SKILL.md [#formato-de-skillmd]
`SKILL.md` es el archivo principal de la Skill y contiene el frontmatter en YAML y un cuerpo en Markdown:
```markdown
---
name: my-custom-skill
description: A concise description shown in the Skill list
metadata:
version: "1.0.0"
author: "Your Name"
license: "MIT"
---
# Detailed Instructions
This is the detailed prompt content the Agent reads.
## Workflow
1. Step one
2. Step two
3. ...
## Best Practices
- Practice suggestion 1
- Practice suggestion 2
```
**Requisitos de los campos del frontmatter:**
* `name` (obligatorio): Debe coincidir con el nombre de la carpeta. Solo se permiten letras minúsculas, números y guiones (`a-z0-9-`). Longitud: 1–64 caracteres. Sin guiones consecutivos ni guiones al inicio o al final.
* `description` (obligatorio): Una descripción breve, máximo 1024 caracteres.
* `metadata` (opcional): Versión, autor, licencia y otra metainformación.
### Instalar Skills personalizadas [#instalar-skills-personalizadas]
**Método 1: Importar mediante Settings**
1. Abre **Settings → Skills**
2. Selecciona **Import Skill**
3. Elige la carpeta de la Skill (o un archivo comprimido `.zip` / `.skill`)
4. Verdent valida `SKILL.md` y la instala en `~/.verdent/skills/`
**Método 2: Copia manual**
```bash
cp -r my-custom-skill ~/.verdent/skills/
```
La Skill queda disponible después de reiniciar Verdent o de actualizar la lista de Skills.
**Método 3: Skill a nivel de proyecto**
Coloca la Skill dentro del directorio de tu proyecto:
```bash
cp -r my-custom-skill /path/to/your/project/.verdent/skills/
```
Las Skills a nivel de proyecto solo son visibles dentro de ese proyecto y tienen prioridad sobre las Skills globales con el mismo nombre.
***
## Ámbitos de las Skills [#ámbitos-de-las-skills]
Verdent admite tres niveles de ámbito para las Skills:
| Nivel | Ubicación | Visibilidad |
| ------------ | ---------------------------- | ------------------------------------------------ |
| **Global** | `~/.verdent/skills/` | Todos los proyectos y espacios de trabajo |
| **Proyecto** | `/.verdent/skills/` | Solo los espacios de trabajo del proyecto actual |
**Reglas de prioridad:**
Cuando existen Skills con el mismo nombre en varios ámbitos:
* El proyecto prevalece sobre el global
***
## Skill Store [#skill-store]
Verdent ofrece un **Skill Store** para explorar e instalar Skills de la comunidad y oficiales.
### Explorar el Skill Store [#explorar-el-skill-store]
1. Abre **Settings → Skills**
2. Cambia a la pestaña **Store**
3. Explora las Skills disponibles o usa el cuadro de búsqueda
### Instalar desde el Store [#instalar-desde-el-store]
1. Encuentra la Skill que deseas en el Store
2. Selecciona **Install**
3. La Skill se descarga e instala automáticamente en `~/.verdent/skills/`
**Verificación de seguridad:**
Las Skills instaladas desde el Store se someten a una verificación de suma de comprobación SHA256 para garantizar la integridad y la seguridad de los archivos.
***
## Ejemplos prácticos [#ejemplos-prácticos]
### Ejemplo 1: Crear una nueva Skill con `skill-creator` [#ejemplo-1-crear-una-nueva-skill-con-skill-creator]
```
@skill-creator help me create a Skill for guiding the team on writing Go unit tests
```
El agente hará lo siguiente:
1. Leer el contenido de la Skill `skill-creator`
2. Guiarte para completar el nombre de la Skill, la descripción y el prompt principal
3. Generar un `SKILL.md` estándar
4. Sugerir la ruta de instalación y los pasos de verificación
### Ejemplo 2: Analizar datos con `spreadsheet` [#ejemplo-2-analizar-datos-con-spreadsheet]
```
@spreadsheet read sales-2025.xlsx from the project root, analyze Q1 sales trends, and generate a chart
```
El agente hará lo siguiente:
1. Cargar la Skill `spreadsheet`
2. Usar `pandas` y `openpyxl` para leer el archivo de Excel
3. Analizar los datos y generar visualizaciones
4. Guardar los resultados o mostrarlos en la conversación
### Ejemplo 3: Arreglar CI con `gh-fix-ci` [#ejemplo-3-arreglar-ci-con-gh-fix-ci]
```
@gh-fix-ci my PR #123 GitHub Actions tests are failing, help me debug
```
El agente hará lo siguiente:
1. Usar la CLI de `gh` para obtener los registros de CI del PR #123
2. Analizar el fallo (por ejemplo, errores en casos de prueba o problemas de dependencias)
3. Proponer una solución
4. Con tu aprobación, modificar el código y enviar la corrección
***
## Preguntas frecuentes [#preguntas-frecuentes]
Cuando se invoca una Skill, el agente lee el archivo `SKILL.md`, lo que cuenta para el uso de tokens y, por lo tanto, consume créditos. Sin embargo, la Skill en sí no realiza llamadas adicionales a API.
Sí. Instala la Skill en `~/.verdent/skills/` (ámbito global) y estará disponible en todos los proyectos.
En **Settings → Skills**, haz clic con el botón derecho en la Skill y selecciona **Delete**. Las Skills integradas marcadas como `undeletable` no se pueden eliminar y se reinstalarán en el próximo inicio.
Sí. Verdent detecta automáticamente las Skills en `~/.cursor/skills`, `~/.claude/skills` y `~/.codex/skills`, y te solicita importarlas. Selecciona **Import from External Sources** en **Settings → Skills**.
* **Project Rule**: Instrucciones siempre activas que se inyectan automáticamente en cada conversación
* **Skill**: Paquetes de conocimiento bajo demanda que se inyectan solo cuando se invocan
Usa las reglas para estándares de programación universales; usa las Skills para flujos de trabajo de dominio específicos.
Las Skills instaladas desde el Skill Store se comprueban automáticamente en busca de actualizaciones en segundo plano. Las Skills instaladas manualmente deben volver a importarse (sobrescribiendo la versión anterior) para actualizarse.
***
## Uso avanzado [#uso-avanzado]
### Incrustar scripts en las Skills [#incrustar-scripts-en-las-skills]
Agrega un directorio `scripts/` a tu Skill y referencia los scripts en `SKILL.md`:
```markdown
## Data Processing Script
Run the following command to process data:
\`\`\`bash
python scripts/process_data.py --input data.csv --output results.json
\`\`\`
```
El agente lee esta instrucción y ejecuta el script según sea necesario.
### Referenciar documentación [#referenciar-documentación]
Almacena documentos, especificaciones o código de ejemplo de API en un directorio `references/` y enlázalos en `SKILL.md`:
```markdown
## Reference Documentation
See [references/api-spec.md](references/api-spec.md) for the detailed API specification.
```
El agente puede leer estos archivos de referencia según las instrucciones de la Skill.
***
## Mejores prácticas [#mejores-prácticas]
**Mantén las Skills enfocadas.** Cada Skill debe orientarse a un único dominio o flujo de trabajo. Evita crear Skills que "lo hagan todo"; en su lugar, divídelas en otras más pequeñas y especializadas.
**Usa nombres claros.** Los nombres de las Skills deben ser concisos y descriptivos, por ejemplo, `api-doc-generator` en lugar de `my-skill-1`.
**Proporciona ejemplos y referencias.** Incluye ejemplos concretos y enlaces de referencia en `SKILL.md` para ayudar al agente a comprender mejor el resultado esperado.
**Mantén los números de versión.** Usa el campo `metadata.version` para hacer seguimiento de las actualizaciones y la compatibilidad.
**Prueba antes de compartir.** Valida tu Skill en un proyecto de prueba antes de implementarla en el equipo o publicarla en el Skill Store.
***
## Consulta también [#consulta-también]
Cómo funcionan los subagentes y cómo gestionarlos
Conecta herramientas y servicios externos mediante MCP
Configura reglas de proyecto y de usuario siempre activas
Revisa los cambios de código con el Reviewer integrado