Anexo · Guías del harness · Script
sync-skills.js
Una sola carpeta de skills para todos los agentes. Escribes tus skills una vez en .agents/skills/ y el script las valida y las copia donde Claude Code las busca.
01Por qué existe
.agents/skills/La fuente única. Codex, Mistral Vibe y Antigravity la leen de forma nativa.
.claude/skills/Copia generada. Claude Code solo busca aquí, así que es el único destino.
02Qué hace
- Valida cada skill contra la especificación Agent Skills (agentskills.io):
nameigual a la carpeta, límites de longitud,descriptionsuficientemente clara, enlaces rotos… Si hay un error, no sincroniza nada. - Copia solo las skills que cambian (copia real, no symlink, para que funcione en Windows).
- Detecta ediciones a mano en la copia de Claude gracias a un manifiesto de hashes, para que no se pierdan sin avisar.
- Limpia las skills que ya no están en la fuente y los destinos antiguos (
.codex/skills,.github/skills).
03Cómo usarlo
Guárdalo en .agents/scripts/sync-skills.js en la raíz de tu repo. Node puro, sin dependencias.
node .agents/scripts/sync-skills.jsValida y sincroniza.node .agents/scripts/sync-skills.js --checkSolo comprueba, no escribe. Ideal para pre-commit o CI.node .agents/scripts/sync-skills.js --forceSincroniza aunque la copia tenga cambios a mano (los pisa).
Truco: añade "sync:skills": "node .agents/scripts/sync-skills.js" a los scripts de tu package.json.
04El código
Cargando…