skill CX Codex

fleet-auditor — Claude Code skill: token audit and installation

Q: How do I install fleet-auditor in Claude Code?

Run `npx skills add alexgreensh/token-optimizer --skill fleet-auditor -a claude-code`. The skill file is available at `~/.claude/skills/fleet-auditor/SKILL.md`.

This skill checks agent systems for token waste and estimates potential savings. Use it to review usage across a fleet of agents.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add alexgreensh/token-optimizer --skill fleet-auditor -a claude-code

Open on GitHub

What fleet-auditor does

The skill detects installed agent systems, gathers token-usage data from sessions, and looks for waste. It runs detection, a session scan, an audit, then prepares findings with severity, estimated monthly savings, and a suggested fix. It does not read or expose message content.

The workflow uses fleet.py with python3 and can optionally create an HTML dashboard. Model prices are needed to calculate dollar amounts. For Codex and systems outside the Claude family, the skill consults a report template that covers cost caveats; without model pricing, dollar savings cannot be calculated.

What it helps with

detect installed agent systems
collect token usage from sessions
find waste and estimate recurring monthly savings
pair each finding with a suggested fix
create an HTML cost dashboard

Example prompts for the agent

Audit my installed agent systems and identify token waste.
Scan session data and estimate monthly savings from the findings.
Create an HTML dashboard of token costs.

How to install fleet-auditor

1Skills CLI (Vercel)

npx skills add alexgreensh/token-optimizer --skill fleet-auditor -a claude-code

2Manually: put the files in place

~/.claude/skills/fleet-auditor/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/fleet-auditor/

1Skills CLI (Vercel)

npx skills add alexgreensh/token-optimizer --skill fleet-auditor -a codex

2Manually: put the files in place

.agents/skills/fleet-auditor/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add alexgreensh/token-optimizer --skill fleet-auditor -a cursor

2Manually: put the files in place

.cursor/skills/fleet-auditor/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install alexgreensh/token-optimizer fleet-auditor

2Manually: put the files in place

.github/skills/fleet-auditor/SKILL.md

1Skills CLI (Vercel)

npx skills add alexgreensh/token-optimizer --skill fleet-auditor -a gemini-cli

2Platform CLI

gemini skills install https://github.com/alexgreensh/token-optimizer --path skills/fleet-auditor

Manually: put the files in place

.devin/skills/fleet-auditor/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add alexgreensh/token-optimizer --skill fleet-auditor -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about fleet-auditor

How do I install fleet-auditor in Claude Code?

Run npx skills add alexgreensh/token-optimizer --skill fleet-auditor -a claude-code. The skill file is available at ~/.claude/skills/fleet-auditor/SKILL.md.

What does fleet-auditor do?

It detects agent systems, gathers token usage, and identifies waste. Its report ranks findings by severity and includes monthly savings estimates and suggested fixes.

Does the audit need model prices?

Yes. Prices are needed to calculate savings in dollars. For Codex and systems outside the Claude family, the skill uses a report template with cost caveats.

setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. 1,052,851installs ask-matt Matt Pocock Routes you to the right Matt Pocock skill or flow for the task at hand. Use it when you need a starting point for a feature, prototype, incoming issue, or hard bug. 766,587installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. CX Codex 282,859installs caveman-review JuliusBrussee Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler. CX Codex +1 411,800installs caveman-compress JuliusBrussee Compresses CLAUDE.md, todo lists, and other prose files into a shorter format while retaining a readable backup. CX Codex +1 411,500installs

From the same set3

token-optimizer Audits Claude Code and Codex setups for context waste, applies approved fixes, and calculates reclaimed tokens. CX Codex +1 976installs token-coach A skill that talks through where your tokens go in a Claude or Codex setup, then proposes changes based on numbers measured on your machine. CX Codex +1 389installs