CommunityProgramación y desarrollogithub.com

steipete/skill-cleaner

Auditoría de skills para Codex/OpenClaw: presupuesto en vivo, uso, duplicados y descripciones compactas.

¿Qué es skill-cleaner?

Skill Cleaner es una herramienta de auditoría para asistentes de IA como Codex y OpenClaw. Su propósito es ayudar a los desarrolladores a gestionar el presupuesto de tokens (prompt budget) de sus skills, identificar skills duplicadas, revisar descripciones largas que pueden acortarse para ahorrar espacio, y detectar skills no utilizadas. Funciona analizando el inventario en vivo de Codex, los archivos históricos de sesiones y las raíces de skills en el sistema de archivos. El script produce un informe detallado que muestra el presupuesto consumido por cada skill, candidatos a descripciones más concisas, duplicados (por nombre, descripción o cuerpo), y skills sin uso reciente. Soporta múltiples modos de análisis: con datos en vivo de Codex, solo basado en archivos, búsqueda profunda en logs archivados, y escaneo de raíces personalizadas. Está diseñado para ser ejecutado desde el directorio del skill o la raíz del repositorio, y sigue las reglas de formato y presupuesto de tokens de Codex (2% de la ventana de contexto, coste de tokens aproximado por bytes UTF-8).

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/skill-cleaner

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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

  1. 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
  1. 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.md en logs recientes de Codex/OpenClaw.
    • Resumen de raíces: de dónde provienen las skills y si la configuración las marca como deshabilitadas.
  2. Antes de eliminar o editar:

    • Verifica que la copia conservada exista y esté cargada.
    • Prefiere eliminar duplicados locales del repo o agent-scripts cuando 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-input proporciona la lista de skills visible para el modelo, orden, nombres y rutas con alias. --no-live fuerza 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, name y description sanitizados en una sola línea.
  • Sigue core-skills/src/render.rs de Codex: 2% del context_window bruto, coste de tokens ceil(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.json para el context_window de 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-only requiere 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/skills no 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.jsonl y los archivos recientes ~/.codex/sessions/**/*.jsonl por defecto. Añade --deep-logs para sesiones archivadas y carpetas de logs comunes de OpenClaw/Clawd.
  • La evidencia de uso es heurística: menciones de $skill/use skill del 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.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Skills relacionados