# Context Optimize

> Analyze and compress context for higher signal-to-noise ratio. Use when GEMINI.md or session context is bloated and needs cleanup. Use when this capability is needed.

- Skill: `tomevault-io/context-optimize-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/context-optimize-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/context-optimize-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/context-optimize-2

---


# Context Optimize Skill (oh-my-gemini)

## Quick Start

- Measure current context size, identify low-signal sections, then propose the smallest cleanup that improves signal density.

Optimize prompt and context files for maximum signal density.

## Quick Start
- GEMINI.md or context files have grown large and unfocused
- Session context feels bloated with stale information
- Token budget is tight and every token must count
- After a major feature addition that expanded context

## Workflow
1. **Audit**: Measure current context size and composition
2. **Score**: Rate each section for signal density (useful / total tokens)
3. **Identify issues**: Flag duplicates, stale entries, verbose sections
4. **Propose changes**: Show diff of recommended optimizations
5. **Apply**: With user approval, apply the optimizations

## Optimization Strategies

| Strategy | Description | Risk |
|----------|-------------|------|
| Deduplicate | Remove repeated instructions across layers | Low |
| Compress | Shorten verbose sections preserving meaning | Low |
| Prioritize | Move high-signal content earlier in context | Low |
| Prune | Remove stale or irrelevant entries | Medium |
| Restructure | Improve formatting for model parsing | Low |

## Metrics

```
Before: 4,200 tokens | Signal: 62% | Redundancy: 18% | Stale: 12%
After:  2,800 tokens | Signal: 89% | Redundancy: 3%  | Stale: 0%
Savings: 33% token reduction
```

## 5-Layer Context Model

oh-my-gemini contexts follow this priority hierarchy:

1. **System/Runtime**: Gemini CLI constraints (immutable)
2. **Project Standards**: GEMINI.md + context/omg-core.md
3. **Session Memory**: .omg/state/, memory entries
4. **Active Task**: Current plan, taskboard, PRD
5. **Execution Traces**: Recent iteration results

Optimization targets layers 2-5 (layer 1 is immutable).

## Safety Rules
- Never remove user-authored content without confirmation
- Always show diff before applying changes
- Preserve semantic meaning — compress, don't delete meaning
- Back up original before modifying

## Related commands
- `/omg:optimize` — quick context optimization command
- `/omg:memory compact` — compact memory entries specifically

---
> Source: [r3dlex/oh-my-gemini](https://github.com/r3dlex/oh-my-gemini) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-23 -->