Agent skill

Skill Cleaner

by steipete in steipete/agent-scripts

Codex/OpenClaw skill audit: live budget, usage, duplicates, compact descriptions.

MITAuto-check passed

Install Skill Cleaner

skills CLI
$ npx skills add steipete/agent-scripts --skill skill-cleaner -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install steipete/agent-scripts skill-cleaner --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/steipete/agent-scripts.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/skill-cleaner .claude/skills/skill-cleaner && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
skill-cleaner
GitHub stars
7.3k
Token cost
~1k tokens
SKILL.md length
423 words
Files
4 (incl. scripts)
Skills in repo
45
Repo updated
First seen
Licence
MIT

At a glance

Codex/OpenClaw skill audit: live budget, usage, duplicates, compact descriptions.

  • SKILL.md covers Workflow, Analyzer Notes and Output Policy
  • Runs TypeScript scripts from its folder; calls node and codex

What it does

Skill Cleaner is an agent skill from steipete/agent-scripts. Codex/OpenClaw skill audit: live budget, usage, duplicates, compact descriptions.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts (for example `agents/openai.yaml`, `scripts/skill-cleaner.test.ts` and `scripts/skill-cleaner.ts`).

The repository describes itself as: Scripts for agents, shared between my repositories. The licence is MIT.

Example prompts

  • “/skill-cleaner”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit 79150cf. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (TypeScript), which the agent can run.

    Shell commands in SKILL.md call:

    • node
    • codex

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Skill Cleaner loads about 1k tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 423 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~24
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from steipete/agent-scripts at commit 79150cf, republished under its MIT licence (© steipete). 423 words, ~1,046 tokens.

Download SKILL.mdSave it as .claude/skills/skill-cleaner/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
skill-cleaner
description
Codex/OpenClaw skill audit: live budget, usage, duplicates, compact descriptions.

Skill Cleaner

Use this when trimming skill prompt budget, finding duplicate skills, auditing enabled/disabled skill roots, or deciding which skills/plugins to remove.

Workflow

  1. Run the analyzer from this skill directory or repo root:
bash
node --experimental-strip-types skills/skill-cleaner/scripts/skill-cleaner.ts --months 3

Useful variants:

bash
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. Read the report in this order:
  • Skill Budget: live Codex inventory, 2% budget, budgeted usage, and full-description pressure.
  • Description candidates: long descriptions where relaxed grammar saves prompt budget.
  • Duplicates: same skill name or near-identical description/body across Codex, plugin cache, repo siblings, and personal skill roots.
  • Unused candidates: no recent user mention or actual SKILL.md read in recent Codex/OpenClaw logs.
  • Root summary: where skills came from and whether config marks them disabled.
  1. Before deleting or editing:
  • Verify the kept copy exists and is loaded.
  • Prefer deleting repo-local or agent-scripts duplicates when Codex built-ins cover them.
  • Keep repo-local OpenClaw maintainer skills when they encode repo policy or live operations.
  • Preserve trigger nouns in descriptions: product, tool, action, object.

Analyzer Notes

  • By default, codex debug prompt-input supplies the exact model-visible skill list, order, names, and aliased paths. --no-live forces the broader filesystem fallback.
  • The broad filesystem scan remains for duplicate, disabled, and archived-cache diagnostics; it is not treated as the loaded inventory.
  • The script mirrors Codex's model-visible line shape: - name: description (file: path).
  • It applies Codex-like frontmatter rules: YAML frontmatter only, default name from parent dir, single-line sanitized name and description.
  • It follows Codex core-skills/src/render.rs: 2% of raw context_window, token cost ceil(utf8_bytes / 4), then full descriptions -> equal description truncation -> omitted minimum lines. Alias-table line cost is included.
  • It reads ~/.codex/models_cache.json for GPT-5.5 context_window; fallback is 272,000 tokens and 2%.
  • It scans only normal Codex/plugin/repo skill roots by default. Extra folders such as Dropbox archives are included only with --root <path>.
  • --root-only requires at least one --root <path>, skips the live Codex inventory, and scans only those supplied roots.
  • It realpath-dedupes roots, so symlinked roots such as ~/.codex/skills/agent-scripts -> ~/Projects/agent-scripts/skills do not create false duplicates.
  • For duplicate names, it reports description/body similarity and suggests deletion candidates only when bodies are near copies. Keep priority defaults to direct Codex system skills, then direct Codex skills, then plugin skills, then personal/repo copies.
  • It scans ~/.codex/history.jsonl and recent ~/.codex/sessions/**/*.jsonl by default. Add --deep-logs for archived sessions and common OpenClaw/Clawd log folders.
  • Usage evidence is heuristic: user $skill/use skill mentions and paths observed in tool-call arguments.
Show full SKILL.md (38 more words)Show less

Output Policy

  • Suggest first; edit only when the user asks.
  • If asked to apply cleanup, make small grouped commits: descriptions, deletes, config disables.
  • Do not delete ignored/untracked skill dirs without naming the destination or confirming they are disposable.

© steipete, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts) in skills/skill-cleaner of steipete/agent-scripts.

  • SKILL.md
  • agents/openai.yaml
  • scripts/skill-cleaner.test.ts
  • scripts/skill-cleaner.ts

Open the folder on GitHubat commit 79150cf

Compare with similar skills

Skill Cleaner next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Skill Cleaner compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skill Cleaner this skillsteipete/agent-scripts7.3k—~1kAutomated safety check: PassMIT
Strategic Compactaffaan-m/ECC275k1 repos~2.1kAutomated safety check: PassMIT
Budget Cash Flowsickn33/agentic-awesome-skills47k1 repos~4.1kAutomated safety check: PassMIT
Tag Duplicate PRs Issuesopenclaw/openclaw392k—~4kAutomated safety check: PassMIT
Token Budget Advisoraffaan-m/ECC275k—~910Automated safety check: PassMIT
Token Budget Advisoraffaan-m/ECC275k—~927Automated safety check: PassMIT

Similar skills

  • Strategic Compact

    affaan-m/ECC

    Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.

    275k GitHub starsUsed in 1 repo~2.1k tokens
    Agent WorkflowsAuto-check passed
  • Budget Cash Flow

    sickn33/agentic-awesome-skills

    Budget against actual by department, category and period, with budget and actual amounts, variance, percentage used and linked expenses.

    47k GitHub starsUsed in 1 repo~4.1k tokens
    Business, Finance & HRAuto-check passed
  • Tag Duplicate PRs Issues

    openclaw/openclaw

    Use gitcrawl to search duplicate OpenClaw PRs/issues, group related work in prtags, and sync duplicate state to GitHub.

    392k GitHub stars~4k tokensUpdated today
    Research & ScienceAuto-check passed
  • 回答する前に、どれだけの回答深度を消費するかについてユーザーに情報に基づいた選択を提供する。ユーザーが回答の長さ、深さ、またはトークンバジェットを明示的に制御したい場合にこのスキルを使用する。トリガー条件:"token budget", "token count", "token usage", "token limit", "response length", "answer depth"…

    275k GitHub stars~910 tokensUpdated 3 days ago
    AI & LLM EngineeringAuto-check passed
  • 在回答前,为用户提供关于消耗多少响应深度的知情选择。当用户明确希望控制响应长度、深度或令牌预算时使用此技能。触发条件:"token budget", "token count", "token usage", "token limit", "response length", "answer depth", "short version", "brief answer", "detailed…

    275k GitHub stars~927 tokensUpdated 3 days ago
    AI & LLM EngineeringAuto-check passed
  • Duplicate JS

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing slow page loads, heavy assets, or rendering delays related to Remove duplicate JavaScript libraries.

    74k GitHub stars~423 tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed

More from steipete/agent-scripts

All 45 skills in this repo
  • Mac Fleet Maintenance

    steipete/agent-scripts

    Inventories and maintains a fleet of Macs from a desired-state file: package updates, repo and Xcode sync, and disk, backup and security health reports.

    7.3k GitHub stars~4.8k tokensUpdated 4 days ago
    Auto-check passed
  • Agent Transcript for PRs

    steipete/agent-scripts

    Finds a coding agent's session log, trims and redacts it, and inserts it into a GitHub PR or issue only when the user has asked for a transcript.

    7.3k GitHub starsUsed in 1 repo~698 tokens
    Auto-check passed
  • Parallels macOS VM Lab

    steipete/agent-scripts

    Uses a clean Parallels macOS VM to test GUI automation, TCC permission prompts and screenshot tools like Peekaboo, verifying results from outside the guest.

    7.3k GitHub stars~1.8k tokensUpdated 4 days ago
    Auto-check passed
  • ClawSweeper Status

    steipete/agent-scripts

    Reports ClawSweeper's status with a bundled script: workflow health, active workers, queue health and recently merged, reviewed, commented and closed items.

    7.3k GitHub stars~972 tokensUpdated 4 days ago
    Auto-check passed
  • GitHub Project Triage

    steipete/agent-scripts

    Produces maintainer-facing triage cards for a project's GitHub issues and pull requests, each with its URL, risk, test state, blockers and a next action.

    7.3k GitHub stars~4k tokensUpdated 4 days ago
    Auto-check passed
  • Nano Banana Image Generation

    steipete/agent-scripts

    Generates and edits images with Google's Nano Banana 2 (Gemini 3.1 Flash Image) through a uv script, with a draft-then-final workflow and sizes from 512 to 4K.

    7.3k GitHub stars~1.4k tokensUpdated 4 days ago
    Auto-check passed

Questions about Skill Cleaner

What does Skill Cleaner do?

Codex/OpenClaw skill audit: live budget, usage, duplicates, compact descriptions. Skill Cleaner is an agent skill from steipete/agent-scripts. Codex/OpenClaw skill audit: live budget, usage, duplicates, compact descriptions.

How do I install Skill Cleaner in Claude Code?

Run `npx skills add steipete/agent-scripts --skill skill-cleaner -a claude-code`. Or copy the skill folder (skills/skill-cleaner in steipete/agent-scripts) into .claude/skills/skill-cleaner in your project. Claude Code loads it when a task matches its description.

How do I install Skill Cleaner in Codex?

Run `npx skills add steipete/agent-scripts --skill skill-cleaner -a codex`. Or copy the skill folder (skills/skill-cleaner in steipete/agent-scripts) into .agents/skills/skill-cleaner in your project. Codex loads it when a task matches its description.

Can I use Skill Cleaner in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add steipete/agent-scripts --skill skill-cleaner -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/skill-cleaner, .gemini/skills/skill-cleaner, .github/skills/skill-cleaner and .opencode/skills/skill-cleaner in your project.

What does Skill Cleaner need to run?

Going by SKILL.md and its folder, Skill Cleaner needs TypeScript for the scripts in its folder and the command-line tools its instructions call (node and codex). Our summary lists: Node.js.

Does Skill Cleaner access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Skill Cleaner safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Skill Cleaner use?

Skill Cleaner is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Skill Cleaner use?

About 1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Skill Cleaner?

Skills that share tags, products or a category with Skill Cleaner: Strategic Compact (affaan-m/ECC, 275k stars), Budget Cash Flow (sickn33/agentic-awesome-skills, 47k stars), Tag Duplicate PRs Issues (openclaw/openclaw, 392k stars) and Token Budget Advisor (affaan-m/ECC, 275k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Skill Cleaner?

steipete (a GitHub user) maintains it in steipete/agent-scripts, which has 7,273 GitHub stars. The repository holds 45 skills in this directory. The repository was last updated on October 4, 2026.

Source: steipete/agent-scripts on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.