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
- 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
- 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 deSKILL.mdem logs recentes do Codex/OpenClaw.Root summary: de onde vieram as skills e se a configuração as marca como desabilitadas.
- Antes de excluir ou editar:
- Verifique se a cópia mantida existe e está carregada.
- Prefira excluir duplicatas locais do repositório ou
agent-scriptsquando 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-inputfornece a lista exata de skills visíveis ao modelo, ordem, nomes e caminhos com alias.--no-liveforç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,
nameedescriptionsanitizados em linha única. - Ele segue o
core-skills/src/render.rsdo Codex: 2% docontext_windowbruto, custo de tokenceil(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.jsonparacontext_windowdo 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-onlyrequer 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/skillsnã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.jsonle~/.codex/sessions/**/*.jsonlrecentes por padrão. Adicione--deep-logspara 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 skille 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.