agentleFS
Anuj7411Anuj7411/sipcode/skills/why/SKILL.md

why

Skill46 starsChanged 31 days agoMITView on GitHub

Forensic audit of the user's most recent Claude Code session. Returns total spend, output ratio, duplicate file reads, idle context after auto-compact, the largest requests (with the tool call each one made), and an estimate of what Sipcode would have RECOVERED if optimizers were active. Use when the user asks "where did my tokens go?", "audit my last session", "why was that session so expensive?", or any forensic question about a past Claude Code session.

112 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use addskill, apply-firmware and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • ryanportfolioSkill

    addskill

    Create, import, update, or install repo or personal skills: runtime ownership, resources, discovery checks.

    Also in 6 projects that use this

  • ryanportfolioSkill

    apply-firmware

    Bring current folder (plain folder, existing repo, old or partial firmware copy) up to full Harness Firmware in place. Mirror external repo → adopt-repo.

    Also in 6 projects that use this

  • +10 more from ryanportfolio

The file

We split this skill into the rules it gives an agent

6 rules. 0 are common, 3 are distinctive, and 3 are very specific to this project.

  • 0

    Common

    Most of the 106 edited versions we read keep these.

  • 3

    Distinctive

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Call the sipcode:audit_latest_session MCP tool to produce a forensic report of the user's most recent Claude Code session.

    line 7
  2. Very specific:

    If the user provides a session ID prefix (e.g., "audit session 3bca35e2"), pass it as the session_id argument.

    line 9
  3. Distinctive:

    When presenting the result:

    line 11
  4. Very specific:

    If you mention the largest requests (topExpensive), say each row's tokens are the whole request's (mostly the context sent with it), not …

    line 14
  5. Distinctive:

    If the session is unusually large (> $10), call that out.

    line 16
  6. Distinctive:

    Do NOT extrapolate the single-session savings across many sessions.

    line 18

“Common” is measured: kept by at least 6 in 10 of the 106 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Sipcode why (session forensics)

Call the sipcode:audit_latest_session MCP tool to produce a forensic report of the user's most recent Claude Code session.

If the user provides a session ID prefix (e.g., "audit session 3bca35e2"), pass it as the session_id argument. Otherwise, omit and the tool will pick the most recent session across all projects.

When presenting the result:

  • Lead with the output ratio (punchline.outputRatioPct: output, meaning the text, code and reasoning the model wrote, as a share of the tokens not read from cache). The other tokens are the context sent with each request (the one-liner says how much of it was read from cache, which costs a fraction of the input price); do not call them exploration or waste.
  • Surface the top 3 leaks with their dollar cost.
  • If you mention the largest requests (topExpensive), say each row's tokens are the whole request's (mostly the context sent with it), not what the tool call cost.
  • The "Sipcode estimates ~X tokens were RECOVERABLE" line is potential, not realized. Only realized after sipcode rules --install + new sessions + sipcode impact. Be explicit about this when relaying the number.
  • If the session is unusually large (> $10), call that out.

Do NOT extrapolate the single-session savings across many sessions. Each session is its own forensic snapshot.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.