1---2name: template3description: <!--4---56<!--7 HOW TO USE THIS TEMPLATE8 ------------------------9 1. Copy `.claude/skills/_template/` to `.claude/skills/<your-skill-name>/`10 2. Replace ALL `<placeholder>` markers below.11 3. Update frontmatter `name`, `description`, `tags`.12 4. Delete this HOW TO block before commit.1314 SIZE LIMITS (SE-208) — TARGET: ≤100 lines | WARN: >100 | FAIL: ≥15015 -------------------------------------------------------------------16 Keep SKILL.md as the lean entry point. Extract heavy content to satellites:1718 .claude/skills/<name>/19 ├── SKILL.md ← ≤100 lines: entry, workflow, references ← YOU ARE HERE20 ├── REFERENCE.md ← extensive technical reference, tables, criteria21 ├── tests.md ← test cases, negative examples, anti-patterns22 ├── examples.md ← concrete input/output examples23 └── DOMAIN.md ← only when real domain terminology exists (not by default)2425 Satellites are NOT loaded by default — the agent reads them on demand.26 SKILL.md links to satellites in the ## Related section.2728 PATTERN: "Authoritative Paths First" (SE-153)29 ---------------------------------------------30 Inspirado en el patrón flowsint. La sección Authoritative Paths31 va PRIMERO, antes de cualquier prosa explicativa o tutorial.32 Razón: agentes leen top-down y se quedan sin contexto. Si los33 paths canónicos están al final, el agente los pierde y empieza34 a inventar firmas. Si están al principio, el agente sabe a35 dónde mirar antes de leer el resto de la skill.36-->3738## Subagent Scope Guard3940> Si fuiste invocado como subagente con una tarea concreta, ejecuta solo41> esa tarea y reporta DONE / DONE_WITH_CONCERNS / BLOCKED. NO actives el42> workflow completo de esta skill. (Borra esta sección si la skill no es43> orquestadora.)4445# Skill: <Nombre Legible>4647<Una frase. Qué problema resuelve.>4849## Authoritative Paths5051> **Lee estos paths antes de actuar. NUNCA asumas firmas, NUNCA inventes paths.**5253| Para | Lee este path |54|---|---|55| <tipos / contratos / interfaces> | `<path/to/types.md>` |56| <handlers / entry points> | `<path/to/handlers/>` |57| <configuración / constantes> | `<path/to/config.md>` |58| <reglas de negocio aplicables> | `<path/to/rules/>` |59| <tests de referencia> | `<path/to/tests/>` |6061**Reglas duras**:62- Si un path no existe, ABORTA y reporta — no inventes uno alternativo.63- Si una firma no está documentada en los paths, lee el código fuente directamente.64- Si la tarea requiere un path no listado aquí, primero añádelo a esta tabla.6566## Cuándo usar6768- <Trigger 1: situación concreta detectable>69- <Trigger 2>70- <Trigger 3>7172## Cuándo NO usar7374- <Anti-trigger 1: situación donde otra skill es más apropiada>75- <Anti-trigger 2>7677## Decision Checklist78791. <Pregunta binaria 1> → si NO: <acción>802. <Pregunta binaria 2> → si NO: <acción>813. <Pregunta binaria 3> → si NO: <acción>8283### Abort Conditions8485- <Condición que invalida la skill — abortar y delegar>86- <Otra>8788## Workflow8990```91<paso 1: input>92 ↓93<paso 2: transformación>94 ↓95<paso 3: output / handoff>96```9798### Detalle de cada paso991001. **<Paso 1>**: <qué hacer, qué leer, qué escribir>1012. **<Paso 2>**: <qué hacer, qué leer, qué escribir>1023. **<Paso 3>**: <qué hacer, qué leer, qué escribir>103104## Outputs esperados105106- <Fichero / commit / PR / mensaje>107- <Métrica observable>108109## Memory hooks110111- <Tipo de fact a guardar tras éxito> → `bash scripts/memory-store.sh save --type <type> --title "<title>" --content "<content>" --source skill:<name>`112- <Tipo de pattern a recall al inicio> → `bash scripts/memory-store.sh recall <topic>`113114## Related115116- Skill: `<../related-skill/SKILL.md>`117- Rule: `<docs/rules/domain/related-rule.md>`118- Spec: `<docs/propuestas/SPEC-XXX.md>`119- Roadmap: `<docs/ROADMAP.md#SE-XXX>`