agents-advisor

Analyzes local AI-agent session logs to estimate recoverable spend and prompt-cache health.

4|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/yeaboi-ai/yeaboi.ai --skill agents-advisor-yeaboi-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agents-advisor
Source: https://github.com/yeaboi-ai/yeaboi.ai/tree/main/claude-plugin/yeaboi/skills/agents-advisor
Command: npx skills add https://github.com/yeaboi-ai/yeaboi.ai --skill agents-advisor-yeaboi-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI-agent bills grow fast and it is hard to see why. This Skill audits local agent session logs to quantify wasted read tokens (identical re-reads, subset re-reads, write read-backs, line-number scaffolding) and to check whether prompt caching is actually working, so you can find the recoverable share of your agent spend. ## Core Features & Use Cases - Read-waste audit: Runs agents_advisor_run over the last 30 days (adjustable 1-365 via window_days) and reports recoverable_usd against total_cost_usd with per-mechanism line items ranked by share of read bytes. - Cache-health diagnostics: Surfaces an alignment_score that flags volatile content (UUIDs, timestamps, JWT-shaped strings, hex digests) in prompt-prefix files, plus gaps_over_5m cache-death windows and residency_median context-residency stats. - History comparison: Uses agents_advisor_history to compare runs over time instead of recomputing. - Use Case: Your Claude Code bill doubled this month. Ask for an agent waste report; the Skill shows that identical file re-reads account for 40% of read bytes and that timestamps in your CLAUDE.md are churning the prompt cache. ## Quick Start Ask the agent to run an agent cost audit with yeaboi and show the recoverable spend and cache health for the last 30 days.

Frequently Asked Questions about agents-advisor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find out why my AI agent bill is so high?

Run the agents_advisor_run audit, which analyzes local session logs and reports recoverable_usd against total_cost_usd. It breaks waste into line items like identical re-reads, subset re-reads, and write read-backs ranked by share of read bytes.

How can I check if my prompt cache is working?

The audit computes an alignment_score below 100 when volatile content such as UUIDs, timestamps, or JWT-shaped strings appears in prompt-prefix files. It also reports gaps_over_5m for likely cache-death windows and residency_median for how long reads stay in context.

Does the agent cost analysis send my transcripts to a server?

No. Transcripts and CLAUDE.md files are read only on your machine. The report carries counts, byte totals, and file paths but never content, and exports are saved locally under ~/.yeaboi/exports/agentwatch/advisor/.

What time window does the agent spend audit cover?

The default audit covers the last 30 days. You can narrow or widen it with the window_days parameter, which accepts values from 1 to 365 days.

Are the recoverable spend figures guaranteed savings?

No. The feature is in beta and figures are estimates of opportunity computed from local logs, with tokens approximated as bytes/4 at the window's blended input rate. Stale re-reads are sized as context but excluded from the recoverable headline.

What happens if no LLM is reachable during the audit?

The tool returns llm_mode set to fallback, meaning the numeric figures are still real but the insights and recommendations prose falls back to deterministic lines. Check the warnings array for details.