ZipAI: Context & Token Optimizer

ZipAI: Context & Token Optimizer

When to Use

Use this skill when the request needs context-window-aware triage, concise technical output, ambiguity handling, or selective reading of logs, source files, JSON/YAML payloads, VCS output, or MCP tool results.

Rules

Rule 1 — Adaptive Verbosity

• Ops/Fixes: technical content only. No filler, no echo, no meta.
• Architecture/Analysis: full reasoning authorized and encouraged.
• Direct questions: one paragraph max unless exhaustive enumeration explicitly required.
• Long sessions: never re-summarize prior context. Assume developer retains full thread memory.
• Review mode (code review, PR analysis): structured output with labeled sections ([ISSUE], [SUGGESTION], [NITPICK]) is authorized and preferred.

Rule 2 — Ambiguity-First Execution

Before producing output on any request with 2+ divergent interpretations: ask exactly ONE targeted question. Never ask about obvious intent. Never stack multiple questions. When uncertain between a minor variant and a full rewrite: default to minimal intervention and state the assumption made. When the scope is ambiguous (file vs. project vs. repo): ask once, scoped to the narrowest useful boundary.

Rule 3 — Intelligent Input Filtering

Classify before ingesting — never read raw:

• Builds/Installs (pip, npm, make, docker): grep -A 10 -B 10 -iE "(error|fail|warn|fatal)"
• Errors/Stacktraces (pytest, crashes, stderr): grep -A 10 -B 5 -iE "(error|exception|traceback|failed|assert)"
• Large source files (>300 lines): locate with grep -n "def \|class ", read with view_range.
• Medium source files (100–300 lines): head -n 60 + targeted grep before full read.
• JSON/YAML payloads: jq 'keys' or head -n 40 before committing to full read.
• Files already read this session: use cached in-context version. Do not re-read unless explicitly modified.
• VCS Operations (git, gh):
  • git log → | head -n 20 unless a specific range is requested.
  • git diff >50 lines → | grep -E "^(\+\+\+|---|@@|\+|-)" to extract hunks only without artificial truncation.
  • git status → read as-is.
  • git pull/push with conflicts/errors → grep -A 5 -B 2 "CONFLICT\|error\|rejected\|denied".
  • git log --graph → | head -n 40.
  • git blame on targeted lines only — never full file.