context-optimize

Files (1)

• SKILL.md

SKILL.md (first lines)

# Context Optimize Skill (oh-my-antigravity)

## 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-antigravity 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

From r3dlex/oh-my-antigravity, MIT.

More from r3dlex/oh-my-antigravity