steipete/skill-cleaner

Audit des compétences Codex/OpenClaw : budget temps réel, utilisation, doublons, descriptions compactes.

Qu'est-ce que skill-cleaner ?

Skill Cleaner est un outil d'audit conçu pour les plateformes d'agents comme Codex et OpenClaw. Il vous aide à gérer votre budget de prompts (target 2% de la fenêtre de contexte), identifier les compétences en double, détecter les descriptions trop longues qui pourraient être réduites, et repérer les compétences inutilisées. L'analyse se base sur plusieurs sources : l'inventaire temps réel fourni par Codex (`codex debug prompt-input`), les caches de plugins, les dossiers de compétences locaux, et les logs d'historique. Le script génère un rapport structuré incluant un budget de compétences, des suggestions de description, une analyse des doublons avec similarité de corps, une liste des compétences candidates à la suppression, et un résumé des racines de compétences. Il prend en charge de nombreuses options de ligne de commande (période en mois, limite de taille de logs, fenêtre de contexte personnalisée, chemins racines, etc.) et s'intègre parfaitement aux workflows de maintenance des compétences. La politique de sortie est prudente : il propose d'abord, et n'édite que sur demande explicite de l'utilisateur.

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

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Skill Cleaner

Utilisez cette compétence lorsque vous réduisez le budget de prompts, trouvez des compétences en double, auditez les racines de compétences activées/désactivées ou décidez quelles compétences/plugins supprimer.

Flux de travail

  1. Exécutez l'analyseur depuis ce répertoire de compétence ou la racine du dépôt :
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --months 3

Variantes utiles :

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. Lisez le rapport dans cet ordre :
  • Budget de compétence : inventaire en direct Codex, budget de 2%, utilisation budgétée et pression des descriptions complètes.
  • Candidates description : descriptions longues où une grammaire relâchée économise le budget de prompts.
  • Doublons : même nom de compétence ou description/corps quasi identique dans Codex, cache de plugins, dépôts frères et racines de compétences personnelles.
  • Candidats inutilisés : aucune mention récente par l'utilisateur ou lecture effective de SKILL.md dans les logs récents de Codex/OpenClaw.
  • Résumé des racines : d'où proviennent les compétences et si la configuration les marque comme désactivées.
  1. Avant de supprimer ou modifier :
  • Vérifiez que la copie conservée existe et est chargée.
  • Préférez supprimer les doublons locaux au dépôt ou agent-scripts lorsque les intégrées Codex les couvrent.
  • Conservez les compétences locales de maintenance OpenClaw lorsqu'elles encodent une politique de dépôt ou des opérations en direct.
  • Préservez les noms déclencheurs dans les descriptions : produit, outil, action, objet.

Notes sur l'analyseur

  • Par défaut, codex debug prompt-input fournit la liste exacte visible par le modèle, l'ordre, les noms et les chemins aliasés. --no-live force la solution de repli plus large du système de fichiers.
  • L'analyse large du système de fichiers reste pour les diagnostics de doublons, désactivés et cache archivé ; elle n'est pas traitée comme l'inventaire chargé.
  • Le script reflète la forme de ligne visible par le modèle dans Codex : - name: description (file: path).
  • Il applique des règles de frontmatter similaires à Codex : frontmatter YAML uniquement, nom par défaut du répertoire parent, name et description nettoyés sur une seule ligne.
  • Il suit core-skills/src/render.rs de Codex : 2% de context_window brute, coût en jetons ceil(utf8_bytes / 4), puis descriptions complètes -> troncature égale des descriptions -> lignes minimales omises. Le coût de la table d'alias est inclus.
  • Il lit ~/.codex/models_cache.json pour context_window de GPT-5.5 ; la valeur par défaut est 272 000 jetons et 2%.
  • Il analyse par défaut uniquement les racines de compétences normales Codex/plugin/dépôt. Les dossiers supplémentaires comme les archives Dropbox ne sont inclus qu'avec --root <path>.
  • --root-only nécessite au moins un --root <path>, ignore l'inventaire en direct Codex et analyse uniquement les racines fournies.
  • Il dédoublonne les racines via realpath, donc les racines liées par symlink comme ~/.codex/skills/agent-scripts -> ~/Projects/agent-scripts/skills ne créent pas de faux doublons.
  • Pour les noms en double, il rapporte la similarité description/corps et suggère des candidats à la suppression uniquement lorsque les corps sont des copies proches. La priorité de conservation par défaut est : compétences système directes Codex, puis compétences directes Codex, puis compétences plugin, puis copies personnelles/dépôt.
  • Il analyse ~/.codex/history.jsonl et les fichiers récents ~/.codex/sessions/**/*.jsonl par défaut. Ajoutez --deep-logs pour les sessions archivées et les dossiers de logs OpenClaw/Clawd courants.
  • La preuve d'utilisation est heuristique : mentions $skill/use skill par l'utilisateur et chemins observés dans les arguments d'appels d'outils.

Politique de sortie

  • Suggérez d'abord ; ne modifiez que lorsque l'utilisateur le demande.
  • Si on vous demande d'appliquer un nettoyage, faites de petits commits groupés : descriptions, suppressions, désactivations de configuration.
  • Ne supprimez pas les répertoires de compétences ignorés/non suivis sans nommer leur destination ou confirmer qu'ils sont jetables.

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 associés