skill-authoringlisted
Install: claude install-skill derj90/agent-project-template
# Cuándo usar
Usar cuando se quiera crear, actualizar o evaluar una skill del proyecto.
# Objetivo
Convertir procesos repetibles en procedimientos reutilizables para agentes, sin inflar el proyecto ni introducir riesgos.
# Cuándo crear una skill
Crear una skill solo si el proceso es:
- repetible;
- útil más de una vez;
- verificable;
- suficientemente específico;
- seguro de automatizar o asistir.
# Cuándo no crear una skill
No crear una skill si:
- es una tarea única;
- es solo una idea vaga;
- duplica una skill existente;
- contiene secretos;
- depende de información que cambia constantemente;
- no tiene criterio de calidad.
# Estructura mínima
```md
---
name: nombre-skill
description: Qué hace y cuándo usarla
---
# Cuándo usar
# Objetivo
# Proceso
# Reglas
# Entregables
# Verificación
# Anti-patrones
```
# Proceso de creación
1. Identificar la repetición.
2. Extraer pasos observables.
3. Definir criterios de calidad.
4. Definir errores a evitar.
5. Escribir la skill en `.agents/skills/<nombre>/SKILL.md`.
6. Crear symlink en `.claude/skills/` si se usará con Claude Code.
7. Probarla en una tarea real.
8. Ajustarla con la experiencia.
# Seguridad
- No incluir claves, tokens, contraseñas ni datos privados.
- No incluir instrucciones destructivas sin aprobación humana.
- No instalar skills externas sin revisar origen, contenido y scripts.
- Preferir skills locales de proyecto antes que globales.
# Regla de mantenimiento
Una skill es un procedimiento viv