Community编程与开发github.com

steipete/skill-cleaner

技能审计工具:实时预算、使用统计、重复检测、描述精简。

skill-cleaner 是什么?

Skill Cleaner 是一个专为 Codex/OpenClaw 环境设计的技能审计工具,帮助开发者管理技能预算、检测重复技能、审计已启用/禁用的技能根目录,并决定哪些技能或插件可以移除。它通过分析模型可见的技能列表、实时预算占用(基于上下文窗口和 token 成本)、描述长度和日志使用证据,生成详细的审计报告。该工具支持多种运行模式,包括实时 Codex 清单、深度日志扫描、自定义根目录扫描,并遵循 Codex 前端规则(YAML 头、名称/描述格式、预算计算)。它能够自动检测重复技能,并根据优先级(系统技能 > 直接技能 > 插件技能 > 个人/仓库副本)推荐删除候选。Skill Cleaner 适用于 Claude Code、Codex、OpenClaw 等平台,帮助开发者优化提示预算、减少冗余、保持技能清单整洁。

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

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Skill Cleaner

在修剪技能提示预算、发现重复技能、审计已启用/禁用的技能根目录,或决定移除哪些技能/插件时,使用此工具。

工作流程

  1. 从此技能目录或仓库根目录运行分析器:
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --months 3

有用的变体:

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. 按以下顺序阅读报告:
  • Skill Budget:实时 Codex 清单,2% 预算,预算使用情况,以及完整描述压力。
  • Description candidates:描述过长的技能,精简语法可节省提示预算。
  • Duplicates:跨 Codex、插件缓存、仓库同级目录和个人技能根目录的相同技能名称或近乎相同的描述/主体。
  • Unused candidates:在最近的 Codex/OpenClaw 日志中,没有用户提及或实际读取 SKILL.md 的技能。
  • Root summary:技能来源以及配置是否标记为禁用。
  1. 在删除或编辑之前:
  • 确认保留的副本存在且已加载。
  • 如果 Codex 内置技能已覆盖,优先删除仓库本地或 agent-scripts 的重复项。
  • 当仓库本地 OpenClaw 维护技能编码了仓库策略或实时操作时,保留它们。
  • 保留描述中的触发名词:产品、工具、动作、对象。

分析器说明

  • 默认情况下,codex debug prompt-input 提供模型可见的精确技能列表、顺序、名称和别名路径。--no-live 强制使用更广泛的文件系统后备方案。
  • 广泛的文件系统扫描仍用于重复、禁用和归档缓存诊断;它不被视为已加载的清单。
  • 脚本镜像 Codex 模型可见的行形式:- name: description (file: path)。
  • 它应用 Codex 类似的前置元数据规则:仅 YAML 前置元数据,默认名称来自父目录,单行清理后的 name 和 description。
  • 它遵循 Codex core-skills/src/render.rs:原始 context_window 的 2%,token 成本 ceil(utf8_bytes / 4),然后完整描述 -> 等量描述截断 -> 省略最小行数。别名表的行成本已包含在内。
  • 它读取 ~/.codex/models_cache.json 以获取 GPT-5.5 context_window;后备方案为 272,000 个 token 和 2%。
  • 默认情况下,仅扫描普通的 Codex/插件/仓库技能根目录。额外的文件夹(如 Dropbox 归档)仅通过 --root <path> 包含。
  • --root-only 需要至少一个 --root <path>,跳过实时 Codex 清单,仅扫描提供的根目录。
  • 它对根目录进行 realpath 去重,因此符号链接根目录(如 ~/.codex/skills/agent-scripts -> ~/Projects/agent-scripts/skills)不会造成虚假重复。
  • 对于重复名称,它报告描述/主体相似度,并仅当主体接近副本时才建议删除候选。保留优先级默认为直接 Codex 系统技能,然后是直接 Codex 技能,再是插件技能,最后是个人/仓库副本。
  • 默认情况下,它扫描 ~/.codex/history.jsonl 和最近的 ~/.codex/sessions/**/*.jsonl。添加 --deep-logs 可扫描归档会话和常见的 OpenClaw/Clawd 日志文件夹。
  • 使用证据是启发式的:用户 $skill/use skill 提及以及在工具调用参数中观察到的路径。

输出策略

  • 先建议;仅在用户要求时进行编辑。
  • 如果要求应用清理,则进行小型分组提交:描述、删除、配置禁用。
  • 在不指明目标或确认它们是可丢弃的情况下,不要删除被忽略/未追踪的技能目录。

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.

相关技能