Skills

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?

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 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

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

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

Verdent incluye un conjunto de Skills integradas que cubren flujos de trabajo comunes:

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

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

SKILL.md es el archivo principal de la Skill y contiene el frontmatter en YAML y un cuerpo en 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

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

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:

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

Verdent admite tres niveles de ámbito para las Skills:

Reglas de prioridad:

Cuando existen Skills con el mismo nombre en varios ámbitos:

• El proyecto prevalece sobre el global

Skill Store

Verdent ofrece un Skill Store para explorar e instalar Skills de la comunidad y oficiales.

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

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

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

@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

@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

Uso avanzado

Incrustar scripts en las Skills

Agrega un directorio scripts/ a tu Skill y referencia los scripts en SKILL.md:

## 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

Almacena documentos, especificaciones o código de ejemplo de API en un directorio references/ y enlázalos en SKILL.md:

## 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

Consulta también