Contrato de Activación
Usa este skill después de instalar, eliminar, crear, mover o renombrar skills, o cuando un delegador necesite un índice de skills actualizado.
Reglas Estrictas
- El registro es un índice, no un compilador ni un resumen.
SKILL.mdsigue siendo la fuente de verdad. - No generes ni inyectes reglas compactas por defecto; preserva la intención del autor pasando rutas exactas de skills a los subagentes.
- Siempre escribe
.atl/skill-registry.mdindependientemente del modo de persistencia SDD. - Guarda el registro en Engram como
topic_key: skill-registrycuando esté disponible, concapture_prompt: false. - Omite los directorios
sdd-*,_sharedyskill-registry; desduplica por nombre de skill, prefiriendo skills a nivel de proyecto sobre skills a nivel de usuario. - Agrega
.atl/a.gitignorecuando sea posible, a menos que esté explícitamente deshabilitado.
Puertas de Decisión
| Situación | Acción |
|---|---|
| El mismo skill existe globalmente y en el proyecto | Conserva el skill a nivel de proyecto |
| El mismo skill existe en múltiples ubicaciones globales | Conserva la primera fuente en el orden de escaneo |
| No se encuentran skills | Escribe un registro vacío para que los agentes dejen de buscar a ciegas |
| El agente delegará trabajo | Selecciona las filas correspondientes del registro y pasa sus rutas de SKILL.md |
Pasos de Ejecución
- Escanea todos los directorios de skills conocidos (de usuario y proyecto) en busca de
*/SKILL.md. - Lee solo el frontmatter según sea necesario para extraer el texto de activación de
nameydescription. - Genera
.atl/skill-registry.mdcon las fuentes escaneadas, el contrato del registro, el nombre del skill, desencadenante/descripción, alcance y ruta exacta. - Persiste en Engram cuando esté disponible usando
title: skill-registry,topic_key: skill-registry,type: config, ycapture_prompt: false. - Devuelve la ruta del registro, la cantidad de skills, el estado de caché y si Engram fue actualizado.
Contrato de Salida
Devuelve:
- Nombre del proyecto y ruta a
.atl/skill-registry.md. - Número de skills indexados.
- Si se usó caché o se regeneró.
- Cualquier skill omitido o duplicado relevante.
Referencias
docs/skill-style-guide.md— cómo deben redactarse los skills antes de indexarlos.skills/_shared/skill-resolver.md— cómo usan el índice los delegadores.