egutierrez
019dcc6fad
Se actualizan las referencias en CLAUDE.md de .claude/policies/ a .claude/rules/, se añade la regla create_issue a la tabla de reglas, y se agrega la nueva sección "Documentación de desarrollo" apuntando a dev/README.md. También se actualiza skills/README.md con la nueva ruta de reglas. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
63 lines
2.1 KiB
Markdown
63 lines
2.1 KiB
Markdown
# Skills
|
|
|
|
Sistema de skills reutilizables para agentes. Las skills son paquetes de instrucciones, scripts y recursos que guian al agente para completar tareas complejas multi-paso.
|
|
|
|
## Diferencia entre Tools y Skills
|
|
|
|
| | Tools | Skills |
|
|
|---|---|---|
|
|
| **Nivel** | Funcion atomica | Flujo multi-paso |
|
|
| **Invocacion** | Function calling del LLM | El agente busca y carga bajo demanda |
|
|
| **Ejemplo** | `ssh_command`, `http_get` | "deploy-service", "log-analyzer" |
|
|
| **Ubicacion** | `tools/<nombre>/` | `skills/<categoria>/<nombre>/` |
|
|
|
|
## Estructura de una skill
|
|
|
|
```
|
|
skills/<categoria>/<nombre>/
|
|
├── SKILL.md ← obligatorio (frontmatter YAML + instrucciones)
|
|
├── scripts/ ← opcional, codigo ejecutable
|
|
├── references/ ← opcional, docs de referencia
|
|
├── templates/ ← opcional, plantillas
|
|
└── assets/ ← opcional, archivos estaticos
|
|
```
|
|
|
|
## SKILL.md — formato
|
|
|
|
```yaml
|
|
---
|
|
name: nombre-skill
|
|
description: >
|
|
Descripcion de que hace y cuando activarse.
|
|
---
|
|
|
|
# Instrucciones
|
|
|
|
Cuerpo markdown con instrucciones completas (< 500 lineas idealmente).
|
|
```
|
|
|
|
## Carga progresiva
|
|
|
|
1. **Metadata** (name + description) — siempre en contexto del agente
|
|
2. **Instrucciones** (cuerpo SKILL.md) — cuando la skill se activa
|
|
3. **Recursos** (scripts/, references/, etc.) — bajo demanda
|
|
|
|
## Categorias
|
|
|
|
| Categoria | Descripcion |
|
|
|-----------|-------------|
|
|
| `devops/` | Operaciones, deploy, infraestructura |
|
|
| `analysis/` | Analisis de datos, logs, metricas |
|
|
| `communication/` | Notificaciones, reportes, mensajeria |
|
|
| `coding/` | Desarrollo, code review, refactoring |
|
|
| `system/` | Administracion de sistemas, monitoreo |
|
|
|
|
## Crear una nueva skill
|
|
|
|
1. Crear directorio: `skills/<categoria>/<nombre>/`
|
|
2. Crear `SKILL.md` con frontmatter YAML (name + description) y cuerpo markdown
|
|
3. Opcionalmente agregar scripts/, references/, templates/, assets/
|
|
4. La skill estara disponible automaticamente para agentes con `skills.enabled: true`
|
|
|
|
Ver regla completa en `.claude/rules/create_skill.md` (pendiente).
|