Skill Cleaner
Úsalo al recortar el presupuesto de skills, encontrar skills duplicadas, auditar raíces de skills habilitadas/deshabilitadas o decidir qué skills/plugins eliminar.
Flujo de trabajo
- Ejecuta el analizador desde este directorio de skill o la raíz del repo:
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --months 3
Variantes útiles:
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --no-logs
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --no-live --no-logs
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --months 6 --max-log-mb 800 --deep-logs
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --context-tokens 272000 --budget-percent 2 --no-logs
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --root ~/Dropbox/boxd/skills --no-logs
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --root ~/.agents/skills --root-only --no-logs
-
Lee el informe en este orden:
- Presupuesto de skills: inventario en vivo de Codex, 2% del presupuesto, uso presupuestado y presión de descripciones completas.
- Candidatos a descripción: descripciones largas donde una gramática más relajada ahorra presupuesto.
- Duplicados: mismo nombre de skill o descripción/cuerpo casi idénticos entre Codex, caché de plugins, gemelos del repo y raíces de skills personales.
- Candidatos no usados: sin mención reciente del usuario ni lectura real de
SKILL.mden logs recientes de Codex/OpenClaw. - Resumen de raíces: de dónde provienen las skills y si la configuración las marca como deshabilitadas.
-
Antes de eliminar o editar:
- Verifica que la copia conservada exista y esté cargada.
- Prefiere eliminar duplicados locales del repo o
agent-scriptscuando los integrados de Codex los cubran. - Conserva las skills de mantenimiento de OpenClaw locales del repo cuando codifiquen políticas del repo u operaciones en vivo.
- Preserva los sustantivos activadores en las descripciones: producto, herramienta, acción, objeto.
Notas del analizador
- Por defecto,
codex debug prompt-inputproporciona la lista de skills visible para el modelo, orden, nombres y rutas con alias.--no-livefuerza el fallback más amplio del sistema de archivos. - El escaneo amplio del sistema de archivos se mantiene para diagnósticos de duplicados, deshabilitados y caché archivado; no se trata como el inventario cargado.
- El script refleja la forma de línea visible para el modelo de Codex:
- name: description (file: path). - Aplica reglas de frontmatter similares a Codex: solo frontmatter YAML, nombre por defecto del directorio padre,
nameydescriptionsanitizados en una sola línea. - Sigue
core-skills/src/render.rsde Codex: 2% delcontext_windowbruto, coste de tokensceil(utf8_bytes / 4), luego descripciones completas -> truncación equitativa de descripciones -> líneas mínimas omitidas. Se incluye el coste de la línea de tabla de alias. - Lee
~/.codex/models_cache.jsonpara elcontext_windowde GPT-5.5; el valor por defecto es 272,000 tokens y 2%. - Escanea solo las raíces de skills normales de Codex/plugin/repo por defecto. Carpetas adicionales como archivos de Dropbox se incluyen solo con
--root <ruta>. --root-onlyrequiere al menos un--root <ruta>, omite el inventario en vivo de Codex y escanea solo esas raíces proporcionadas.- Deduplica raíces mediante realpath, por lo que raíces con enlaces simbólicos como
~/.codex/skills/agent-scripts -> ~/Projects/agent-scripts/skillsno crean falsos duplicados. - Para nombres duplicados, reporta similitud de descripción/cuerpo y sugiere candidatos a eliminación solo cuando los cuerpos son casi copias. La prioridad de conservación por defecto es: skills directas del sistema Codex, luego skills directas de Codex, luego skills de plugins, luego copias personales/del repo.
- Escanea
~/.codex/history.jsonly los archivos recientes~/.codex/sessions/**/*.jsonlpor defecto. Añade--deep-logspara sesiones archivadas y carpetas de logs comunes de OpenClaw/Clawd. - La evidencia de uso es heurística: menciones de
$skill/use skilldel usuario y rutas observadas en argumentos de llamadas a herramientas.
Política de salida
- Sugerir primero; editar solo cuando el usuario lo pida.
- Si se solicita aplicar limpieza, realizar pequeños commits agrupados: descripciones, eliminaciones, deshabilitaciones en configuración.
- No eliminar directorios de skills ignorados/no rastreados sin nombrar el destino o confirmar que son prescindibles.