steipete/skill-cleaner

Auditoria de skills Codex/OpenClaw: orçamento ao vivo, uso, duplicatas, descrições compactas.

O que é skill-cleaner?

O Skill Cleaner é uma ferramenta de auditoria de skills para agentes de IA como Codex e OpenClaw. Ele ajuda a gerenciar o orçamento de tokens de prompt, identificar skills duplicadas, auditar raízes de skills habilitadas/desabilitadas e decidir quais skills ou plugins remover. A ferramenta analisa o inventário ao vivo do Codex, calcula o orçamento de habilidades com base no contexto disponível (2% do `context_window`), e fornece um relatório detalhado que inclui: orçamento atual de skills, candidatos a descrições mais curtas para economizar tokens, duplicatas (por nome ou similaridade de descrição/corpo), skills não utilizadas, e um resumo das raízes de skills. O script suporta múltiplas opções de linha de comando para controlar a profundidade da análise, como `--no-logs`, `--no-live`, `--deep-logs`, e `--root <path>` para incluir pastas extras. A política de saída prioriza sugestões sobre ações diretas, e recomenda fazer commits em pequenos grupos ao aplicar limpezas. É útil para desenvolvedores que mantêm uma grande coleção de skills e precisam otimizar o uso do prompt budget.

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

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Skill Cleaner

Use isto ao reduzir o orçamento de prompt de skills, encontrar skills duplicadas, auditar raízes de skills habilitadas/desabilitadas ou decidir quais skills/plugins remover.

Fluxo de Trabalho

  1. Execute o analisador a partir deste diretório de skill ou raiz do repositório:
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --months 3

Variantes úteis:

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. Leia o relatório nesta ordem:
  • Skill Budget: inventário ao vivo do Codex, orçamento de 2%, uso orçado e pressão de descrições completas.
  • Description candidates: descrições longas onde gramática relaxada economiza orçamento de prompt.
  • Duplicates: mesmo nome de skill ou descrição/corpo quase idêntico entre Codex, cache de plugins, irmãos de repositório e raízes de skills pessoais.
  • Unused candidates: nenhuma menção recente do usuário ou leitura real de SKILL.md em logs recentes do Codex/OpenClaw.
  • Root summary: de onde vieram as skills e se a configuração as marca como desabilitadas.
  1. Antes de excluir ou editar:
  • Verifique se a cópia mantida existe e está carregada.
  • Prefira excluir duplicatas locais do repositório ou agent-scripts quando as skills internas do Codex as cobrirem.
  • Mantenha skills de manutenção do OpenClaw locais do repositório quando elas codificam política do repositório ou operações ao vivo.
  • Preserve substantivos-gatilho em descrições: produto, ferramenta, ação, objeto.

Notas do Analisador

  • Por padrão, codex debug prompt-input fornece a lista exata de skills visíveis ao modelo, ordem, nomes e caminhos com alias. --no-live força o fallback mais amplo do sistema de arquivos.
  • A varredura ampla do sistema de arquivos permanece para diagnósticos de duplicatas, desabilitadas e cache arquivado; não é tratada como o inventário carregado.
  • O script espelha a forma de linha visível ao modelo do Codex: - name: description (file: path).
  • Ele aplica regras de frontmatter semelhantes às do Codex: apenas YAML frontmatter, nome padrão do diretório pai, name e description sanitizados em linha única.
  • Ele segue o core-skills/src/render.rs do Codex: 2% do context_window bruto, custo de token ceil(utf8_bytes / 4), depois descrições completas -> truncamento igual de descrição -> linhas mínimas omitidas. Custo de linha da tabela de alias está incluído.
  • Ele lê ~/.codex/models_cache.json para context_window do GPT-5.5; fallback é 272.000 tokens e 2%.
  • Por padrão, ele varre apenas raízes de skills normais do Codex/plugin/repositório. Pastas extras, como arquivos Dropbox, são incluídas apenas com --root <path>.
  • --root-only requer pelo menos um --root <path>, ignora o inventário ao vivo do Codex, e varre apenas essas raízes fornecidas.
  • Ele deduplica raízes por caminho real, então raízes com link simbólico como ~/.codex/skills/agent-scripts -> ~/Projects/agent-scripts/skills não criam duplicatas falsas.
  • Para nomes duplicados, ele relata similaridade de descrição/corpo e sugere candidatos a exclusão apenas quando os corpos são quase cópias. A prioridade de manutenção padrão é: skills diretas do sistema Codex, depois skills diretas do Codex, depois skills de plugins, depois cópias pessoais/de repositório.
  • Ele varre ~/.codex/history.jsonl e ~/.codex/sessions/**/*.jsonl recentes por padrão. Adicione --deep-logs para sessões arquivadas e pastas de log comuns do OpenClaw/Clawd.
  • A evidência de uso é heurística: menções do usuário $skill/use skill e caminhos observados em argumentos de chamada de ferramenta.

Política de Saída

  • Sugira primeiro; edite apenas quando o usuário pedir.
  • Se solicitado a aplicar limpeza, faça commits pequenos agrupados: descrições, exclusões, desabilitações de configuração.
  • Não exclua diretórios de skill ignorados/não rastreados sem nomear o destino ou confirmar que são descartáveis.

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.

Habilidades Relacionadas