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
- 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
- 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 deSKILL.mddans 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.
- 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-scriptslorsque 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-inputfournit la liste exacte visible par le modèle, l'ordre, les noms et les chemins aliasés.--no-liveforce 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,
nameetdescriptionnettoyés sur une seule ligne. - Il suit
core-skills/src/render.rsde Codex : 2% decontext_windowbrute, coût en jetonsceil(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.jsonpourcontext_windowde 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-onlyné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/skillsne 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.jsonlet les fichiers récents~/.codex/sessions/**/*.jsonlpar défaut. Ajoutez--deep-logspour les sessions archivées et les dossiers de logs OpenClaw/Clawd courants. - La preuve d'utilisation est heuristique : mentions
$skill/use skillpar 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.