agentleFS
rade-nugrohorade-nugroho/Agentic-Enteprises-Skill/ai-token-improvement-plan-engineer/SKILL.md

ai-token-improvement-plan-engineer

Skill9 starsChanged 6 months agoMITView on GitHub

Guides creation of AI token and cost improvement plans—baseline audits, spend attribution, optimization initiative backlog (prompt, context, model routing, RAG, agents), impact estimates, quality guardrails, measurement KPIs, and phased rollout with owners. Use when building a token reduction roadmap, cost optimization program, LLM unit-economics improvement plan, or executive brief on cutting inference spend without breaking evals—not for hands-on context layout implementation (ai-context-engineer), single-prompt rewrites (prompt-engineer), RAG pipeline build (ai-engineer), or AI ops cadence and vendor governance (ai-lead-ops). For end-to-end commercial/enterprise AI solution architecture before cost programs, use applied-ai-architect-commercial-enterprise. Empirical token studies and ablations: research-engineer-scientist-tokens.

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Every initiative must list:

    line 94

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “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

AI Token Improvement Plan Engineer

When to Use

  • Audit where tokens are spent (by feature, model, tenant, turn type)
  • Prioritize cost-saving initiatives with estimated savings and risk
  • Draft a phased improvement plan with metrics and rollback criteria
  • Define eval gates so cost cuts do not regress quality or safety
  • Brief leadership on trade-offs (model tier, context size, agent depth)

When NOT to Use

  • Implement context packing or compression code → ai-context-engineer
  • Rewrite one prompt or agent tool schema → prompt-engineer
  • Build RAG ingest, chunking, or agent runtime → ai-engineer
  • Weekly cost review ritual and release governance → ai-lead-ops
  • Memory store architecture → ai-memory-developer
  • Adversarial safety testing → ai-redteam
  • AI policy and regulatory mapping → ai-risk-governance

Related skills

NeedSkill
Context budget and truncationai-context-engineer
Prompt patterns and eval of wordingprompt-engineer
RAG and agent implementationai-engineer
Production ops and cost reviewsai-lead-ops
Memory write/read policyai-memory-developer
Safety regression testingai-redteam
AI solution architecture (commercial/enterprise)applied-ai-architect-commercial-enterprise
Token efficiency experiments and benchmarksresearch-engineer-scientist-tokens

Core Workflows

1. Scope and baseline

Define:

  • Surface area — chat, copilot, batch, agents, embeddings-only
  • Time window — 7/30 days; exclude anomalies (launches, incidents)
  • Segmentation — model, feature flag, tenant tier, environment

Collect baseline metrics (see references/token_audit.md).

Deliverable: current state table with top 5 cost drivers (≥70% of spend if possible).

2. Categorize spend

Bucket each driver:

CategoryExamples
Input bloatLong system prompts, duplicated docs, full chat history
Output bloatVerbose defaults, no max_tokens, unconstrained agents
Model choiceOpus-class for simple classification
RetrievalOver-fetching chunks, huge tool results in context
Agent loopsExtra tool rounds, retry storms
InfrastructureRe-embedding unchanged corpora, log payloads in prompts

Tag fixed per request vs scales with users/sessions.

3. Initiative backlog

For each idea record:

  • Description and owner team
  • Estimated savings (% tokens or $/month) with assumptions
  • Effort (S/M/L) and dependencies
  • Quality risk (low/med/high) and required evals
  • Measurement — metric that proves success

Prioritize with impact × confidence ÷ effort; never ship without eval plan.

See references/improvement_backlog.md and references/optimization_playbook.md.

4. Quality and safety guardrails

Every initiative must list:

  • Golden-set evals (task accuracy, format)
  • Safety set (if user-facing)
  • Latency check (p95)
  • Rollback trigger (e.g., CSAT drop, eval regression >X%)

See references/measurement_and_kpis.md.

5. Phased plan

Typical phases:

PhaseFocusDuration
0 — MeasureInstrumentation, dashboards, attribution1–2 weeks
1 — Quick winsmax_tokens, model routing, prompt trim, cache2–4 weeks
2 — StructureRAG top-k, history compression, tool output limits4–8 weeks
3 — ArchitectureAgent budget caps, routing policies, batch/offline8+ weeks

Each phase: goals, initiatives, owners, exit criteria.

See references/rollout_plan.md.

6. Executive summary

## Situation — spend and growth rate
## Target — $ or tokens/session goal by date
## Top drivers — ranked list
## Plan — 3–5 initiatives per phase
## Risks — quality, latency, eng capacity
## Asks — budget, headcount, eval time

Hand ongoing ops to ai-lead-ops after plan approval.

When to load references

  • Baseline and attribution → references/token_audit.md
  • Backlog template and scoring → references/improvement_backlog.md
  • Technique catalog → references/optimization_playbook.md
  • KPIs and eval gates → references/measurement_and_kpis.md
  • Phasing and rollback → references/rollout_plan.md

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.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

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.