feat: scaffold del sistema de skills
Estructura inicial de skills organizadas por categoría (analysis, coding, communication, devops, system). Incluye README con convenciones de formato y directorio por skill con sus prompts. Las skills son plantillas de prompts reutilizables que los agentes pueden invocar para tareas especializadas. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,62 @@
|
||||
# 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 policy completa en `.claude/policies/create_skill.md` (pendiente).
|
||||
Reference in New Issue
Block a user