CommunityCodierung & Entwicklunggithub.com

steipete/skill-cleaner

Skill-Audit für Codex/OpenClaw: Live-Budget, Nutzung, Duplikate, kompakte Beschreibungen.

Was ist skill-cleaner?

Dieses Skill hilft Entwicklern und KI-Agenten dabei, das Skill-Prompt-Budget zu trimmen, doppelte Skills zu identifizieren und zu entscheiden, welche Skills oder Plugins entfernt werden sollten. Es unterstützt Codex, OpenClaw und ähnliche Agenten-Plattformen und führt eine Live-Analyse der geladenen Skills sowie eine breite Dateisystem-Suche nach Duplikaten, deaktivierten oder archivierten Skripten durch. Das Tool verwendet einen Node.js-Analyzer, der den Kontextfenster-Budget (standardmäßig 2 % von 272.000 Tokens) berechnet, Beschreibungslängen optimiert und anhand von Logs die tatsächliche Nutzung von Skills prüft. Die Ausgabe umfasst Berichte zu Skill-Budget, Beschreibungskandidaten, Duplikaten, ungenutzten Skills und einer Root-Zusammenfassung. Änderungen werden nur nach Benutzeraufforderung vorgeschlagen oder angewendet.

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

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Skill Cleaner

Verwende dies, um das Skill-Prompt-Budget zu trimmen, doppelte Skills zu finden, aktivierte/deaktivierte Skill-Roots zu auditieren oder zu entscheiden, welche Skills/Plugins entfernt werden sollen.

Arbeitsablauf

  1. Führe den Analyzer aus diesem Skill-Verzeichnis oder dem Repository-Root aus:
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --months 3

Nützliche Varianten:

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. Lies den Bericht in dieser Reihenfolge:
  • Skill Budget: Live-Codex-Inventar, 2 % Budget, budgetierte Nutzung und Vollbeschreibungsdruck.
  • Beschreibungskandidaten: Lange Beschreibungen, bei denen eine entspannte Grammatik Prompt-Budget spart.
  • Duplikate: Gleicher Skill-Name oder nahezu identische Beschreibung/Body über Codex, Plugin-Cache, Repository-Geschwister und persönliche Skill-Roots hinweg.
  • Ungenutzte Kandidaten: Keine kürzliche Benutzererwähnung oder tatsächliches Lesen von SKILL.md in aktuellen Codex/OpenClaw-Logs.
  • Root-Zusammenfassung: Woher Skills stammen und ob die Konfiguration sie als deaktiviert markiert.
  1. Vor dem Löschen oder Bearbeiten:
  • Stelle sicher, dass die behaltene Kopie existiert und geladen ist.
  • Bevorzuge das Löschen von Duplikaten aus dem Repository-lokalen Bereich oder agent-scripts, wenn Codex-Eingebauten sie abdecken.
  • Behalte Repository-lokale OpenClaw-Maintainer-Skills, wenn sie Repository-Policy oder Live-Operationen kodieren.
  • Bewahre Trigger-Nomen in Beschreibungen: Produkt, Werkzeug, Aktion, Objekt.

Analysator-Hinweise

  • Standardmäßig liefert codex debug prompt-input die exakte modellsichtbare Skill-Liste, Reihenfolge, Namen und Alias-Pfade. --no-live erzwingt den breiteren Dateisystem-Fallback.
  • Der breite Dateisystem-Scan bleibt für Duplikat-, deaktivierte und archivierte-Cache-Diagnosen erhalten; er wird nicht als geladenes Inventar behandelt.
  • Das Skript spiegelt Codex' modellsichtbare Zeilenform wider: - name: description (file: path).
  • Es wendet Codex-ähnliche Frontmatter-Regeln an: nur YAML-Frontmatter, Standardname aus dem übergeordneten Verzeichnis, einzeiliger bereinigter name und description.
  • Es folgt Codex core-skills/src/render.rs: 2 % des rohen context_window, Token-Kosten ceil(utf8_bytes / 4), dann vollständige Beschreibungen -> gleiche Beschreibungskürzung -> ausgelassene Mindestzeilen. Alias-Tabellen-Zeilenkosten sind enthalten.
  • Es liest ~/.codex/models_cache.json für GPT-5.5 context_window; Fallback sind 272.000 Tokens und 2 %.
  • Standardmäßig scannt es nur normale Codex/Plugin/Repo-Skill-Roots. Zusätzliche Ordner wie Dropbox-Archive werden nur mit --root <pfad> eingeschlossen.
  • --root-only erfordert mindestens ein --root <pfad>, überspringt das Live-Codex-Inventar und scannt nur die angegebenen Roots.
  • Es dedupliziert Roots per realpath, sodass symbolisch verlinkte Roots wie ~/.codex/skills/agent-scripts -> ~/Projects/agent-scripts/skills keine falschen Duplikate erzeugen.
  • Für doppelte Namen meldet es Ähnlichkeit von Beschreibung/Body und schlägt Löschkandidaten nur vor, wenn die Bodies nahezu Kopien sind. Die Behaltenspriorität ist standardmäßig: direkte Codex-System-Skills, dann direkte Codex-Skills, dann Plugin-Skills, dann persönliche/Repo-Kopien.
  • Es scannt ~/.codex/history.jsonl und aktuelle ~/.codex/sessions/**/*.jsonl standardmäßig. Füge --deep-logs für archivierte Sitzungen und übliche OpenClaw/Clawd-Log-Ordner hinzu.
  • Nutzungsnachweise sind heuristisch: Benutzer-$skill/use skill-Erwähnungen und Pfade, die in Tool-Call-Argumenten beobachtet wurden.

Ausgabe-Richtlinie

  • Zuerst vorschlagen; nur bearbeiten, wenn der Benutzer darum bittet.
  • Wenn um Bereinigung gebeten wird, kleine gruppierte Commits erstellen: Beschreibungen, Löschungen, Konfigurations-Deaktivierungen.
  • Ignorierte/nicht verfolgte Skill-Verzeichnisse nicht löschen, ohne das Ziel zu nennen oder zu bestätigen, dass sie entsorgbar sind.

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.

Verwandte Skills