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