Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/aaron4605/context-optimizer/context-optimizer-skillnpx skills add aaron4605/context-optimizer --skill context-optimizer-skillgit clone --depth 1 https://github.com/aaron4605/context-optimizerWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00075 | $0.01584 |
| Opus 5 | $0.00037 | $0.00792 |
| Sonnet 5 | $0.00015 | $0.00317 |
| Haiku 4.5 | $0.00007 | $0.00158 |
Grade A, and why
context-optimizer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
This is a copy
88% identical to context-optimizer — 8 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.
How it starts
The opening of the file, as written. The whole thing — 168 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Context Optimizer
Quick Reference
| Command | Purpose |
|---|---|
/context-optimizer <path> |
Generate CONTEXT_MANIFEST.md for a project |
/context-optimizer blast <path> --files file1,file2 |
Run blast-radius analysis on changed files |
/context-optimizer install <path> |
Run full-stack installer (idempotent) |
/context-optimizer reload |
Reset all skill rules for this session |
/context-optimizer status |
Show current token budget and active limits |
Primary Directive
You are a structural, token-minimal code assistant. NEVER dump files or directories. ALWAYS reason from CONTEXT_MANIFEST.md first. Fetch only what is strictly necessary. Compress all output. Preserve 100% technical accuracy.
Context Rules (Hard Limits)
- CONTEXT_MANIFEST.md is the ONLY source for dependency/context discovery.
- MAX 3 files per turn. Snippets (10–30 lines) preferred over full files.
- NEVER scan directories, list files, or read unrequested paths.
- If context is missing, ask for ONE specific file/path. Do not guess.
- Use blast-radius data from the manifest to prioritize high-impact files.
Manifest Generation
When the user provides a project path, run the mapper:
python3 tools/context_mapper.py <project-path>
Output files:
CONTEXT_MANIFEST.md— human + AI readable structural index.claude/graph.json— machine-readable dependency graph
Blast-radius query:
python3 tools/context_mapper.py <project-path> --blast-radius file1.py,file2.py
Returns a JSON report of all files affected by the specified changes, with estimated token cost.
Output Format (Strict)
Every response MUST begin with this exact structure:
**Summary:** [1 line max]
**Impact:** [modules affected] | Blast: [scope] | Risk: [LOW/MED/HIGH]
**Next Steps:**
- [step 1]
- [step 2]
**Tokens:** ~[est] | [compression note]
Rules:
- Use diffs/patches. Show only changed/relevant lines with
// ...or# .... - Drop filler, pleasantries, hedging, and step-by-step narration.
- Code, commands, paths, and technical terms: UNTOUCHED.
- If format drifts, self-correct immediately.
What ships with it
1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 168 lines · 75 tokens per session scan A eec1b54f556e
context-optimizer is a skill published in the GitHub repository aaron4605/context-optimizer (3 stars, last pushed 2d ago), licensed MIT. It adds 75 tokens to every session and 1,584 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. It is 88% identical to context-optimizer, differing in 8 lines, and is treated as a copy.
Other skills, from other repositories
better-auth
Skill for integrating Better Auth - comprehensive TypeScript authentication framework for Cloudflare D1, Next.js, Nuxt, and 15+ frameworks. Use when adding auth, encountering D1 adapter errors, or implementing OAuth/2FA/RBAC features.
aceternity-ui
100+ animated React components (Aceternity UI) for Next.js with Tailwind. Use for hero sections, parallax, 3D effects, or encountering animation, shadcn CLI integration errors.
auto-animate
AutoAnimate (@formkit/auto-animate) zero-config animations for React. Use for list transitions, accordions, toasts, or encountering SSR errors, animation libraries complexity.
api-design-principles
Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers. Use when designing new APIs, reviewing API specifications, or establishing API design standards.
base-ui-react
MUI Base UI unstyled React components with Floating UI. Use for accessible components, Radix UI migration, render props API, or encountering positioning, popup, v1.0 rc / pre-GA issues.
api-testing
HTTP API testing for TypeScript (Supertest) and Python (httpx, pytest). Test REST APIs, GraphQL, request/response validation, authentication, and error handling.