Agent skill

Compress

by cwinvestments in cwinvestments/memstack

A skill your agent uses when the user says 'tokenstack', 'compression', 'token savings', 'proxy status', or asks about context window usage.

MITAuto-check passedAgent Workflows

Install Compress

skills CLI
$ npx skills add cwinvestments/memstack --skill compress -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install cwinvestments/memstack compress --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/cwinvestments/memstack.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/compress .claude/skills/compress && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
compress
GitHub stars
423
Token cost
~1.2k tokens
SKILL.md length
579 words
Files
1
Skills in repo
87
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user says 'tokenstack', 'compression', 'token savings', 'proxy status', or asks about context window usage.

  • Works in 4 steps: Health Check → Confirm Routing → Diagnose "not running" → …
  • The user says tokenstack
  • SKILL.md covers Activation, Context Guard, What It Does and Prerequisites, plus 7 more sections
  • Calls python and curl

What it does

Compress is an agent skill from cwinvestments/memstack. Use when the user says 'tokenstack', 'compression', 'token savings', 'proxy status', or asks about context window usage.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Context engineering. The repository describes itself as: Structured skill framework for Claude Code. 130 skills, persistent memory, TokenStack compression, localhost dashboard with 3-agent runner, real-time streaming, MCP tools. The licence is MIT.

When your agent uses it

  • The user says tokenstack
  • Asks about context window usage

Example prompts

  • “tokenstack”
  • “compression”
  • “token savings”
  • “/compress”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Health Check
  2. Confirm Routing
  3. Diagnose "not running"
  4. Reading Savings

What it can do on your machine

Read from SKILL.md and the folder at commit 00370ce. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python
    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use curl, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Compress loads about 1.2k tokens when it runs. Until then it costs about 32 tokens; SKILL.md has 579 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~32
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from cwinvestments/memstack at commit 00370ce, republished under its MIT licence (© cwinvestments). 579 words, ~1,243 tokens.

Download SKILL.mdSave it as .claude/skills/compress/SKILL.md (or your agent's skills folder).
name
compress
description
Use when the user says 'tokenstack', 'compression', 'token savings', 'proxy status', or asks about context window usage.
version
2.0.0

Compress - TokenStack Proxy Manager

Monitor and troubleshoot the built-in TokenStack compression proxy for CC sessions.

Activation

When this skill activates, output:

Compress - Checking TokenStack status...

Then execute the protocol below.

  • Keywords: tokenstack, compression stats, token savings, proxy status, check proxy
  • Contextual: When user asks about token usage, context window limits, or session cost
  • Level: 2 (explicit trigger only)

Context Guard

ContextStatus
User says "tokenstack", "compression stats", "check proxy"ACTIVE - run status check
User asks about token savings or context windowACTIVE - point to dashboard report
Proxy errors or API connection failures appearACTIVE - run health diagnostics
General discussion about CC featuresDORMANT - do not activate
User is actively coding (no proxy issues)DORMANT - do not activate

What It Does

TokenStack is a transparent proxy between Claude Code and the Anthropic API. It compresses tool output before it reaches the API, extending effective context and lowering token cost.

This skill checks that the proxy is running and routing, and troubleshoots connection issues. For the full feature overview, enable steps, and transform tables, use the Token Optimization skill.

Prerequisites

TokenStack ships inside the memstack-skill-loader package. There is no separate install.

  • Start with the dashboard (recommended): python -m memstack_skill_loader dashboard --with-proxy
    • Starts the proxy on 127.0.0.1:8787 and sets ANTHROPIC_BASE_URL automatically.
  • Run only the proxy: python -m memstack_skill_loader proxy

Workflow

1. Health Check
cmd
curl http://127.0.0.1:8787/health

A healthy proxy responds on /health. If there is no response, the proxy is not running.

Note: the proxy has no /stats endpoint. Live savings are reported in the dashboard, not over curl. See "Reading Savings" below.

2. Confirm Routing

Open the dashboard and look at the proxy indicator. A live PRO or FREE badge means Claude Code traffic is routing through TokenStack. If the badge reads "not detected," the dashboard was started without --with-proxy; restart it with the flag.

3. Diagnose "not running"

Check the port:

cmd
netstat -ano | findstr 8787

If nothing is listening, start it:

cmd
python -m memstack_skill_loader dashboard --with-proxy
4. Reading Savings

Savings live in the dashboard (default http://localhost:3333):

  • Proxy indicator: PRO or FREE badge with session and 30-day percentages
  • Overview header: session and lifetime tokens saved
  • Burn Report: per-transform breakdown, estimated cost, time filters (all-time, daily, weekly, monthly), and a per-agent split for the Manager, Builder, and Reviewer
Show full SKILL.md (216 more words)Show less

Tier Behavior

TierTransforms
FreeSix lossless text reductions, always applied
ProAdds seven transforms including AST truncation (license-gated)

A valid Pro license switches the proxy to Pro tier automatically. The dashboard badge shows the active tier.

Troubleshooting

SymptomFix
No response on /healthProxy not running. Start with python -m memstack_skill_loader dashboard --with-proxy.
Proxy indicator shows "not detected"Dashboard was started without --with-proxy. Restart with the flag.
Badge shows FREE but you hold ProLicense cache may be stale. The proxy revalidates the license on next start.
Cost figures differ from Anthropic ConsoleEstimates use list token prices and do not model server-side prompt caching. For billed cost, check console.anthropic.com.

Output Format

TokenStack Status
  Proxy: Running on :8787
  Tier: PRO
  Savings: read in the dashboard (Overview header and Burn Report)

Integration

  • Dashboard: proxy indicator, Overview header, and Burn Report
  • CC sessions: auto-routed when the dashboard is started with --with-proxy
  • Standalone proxy: python -m memstack_skill_loader proxy

Relationship to Other Skills

SkillScopeWhen to Use
Token OptimizationFull TokenStack overview, enable steps, transform tablesUnderstanding or turning on compression
Compress (this)Health, routing, troubleshootingProxy not running or not routing

Level History

  • Lv.1 - Base: health check and stats reporting for the legacy Headroom proxy. (Origin: MemStack, Feb 2026)
  • Lv.2 - Rewrite: retargeted to the built-in TokenStack proxy. Removed the external Headroom install and the /stats curl; savings are now read from the dashboard. (Jun 2026)

© cwinvestments, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/compress of cwinvestments/memstack.

Open the folder on GitHubat commit 00370ce

Compare with similar skills

Compress next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Compress compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Compress this skillcwinvestments/memstack423—~1.2kAutomated safety check: PassMIT
Context Mode Output Sandboxmksglu/context-mode26k—~4.1kAutomated safety check: PassCustom licence
Memori Long-Term MemoryMemoriLabs/Memori17k—~2kAutomated safety check: NotesCustom licence
Picoclaw Skill Creatorsipeed/picoclaw30k—~4.4kAutomated safety check: PassMIT
ccc Semantic Code Searchcocoindex-io/cocoindex-code2.8k—~938Automated safety check: PassApache-2.0
Context Mode for Antigravity CLImksglu/context-mode26k—~850Automated safety check: PassCustom licence

Similar skills

  • Context Mode Output Sandbox

    mksglu/context-mode

    Routes large command, file, API and browser output through context-mode tools so only the needed result enters the agent's context, instead of dumping it via Bash.

    26k GitHub stars~4.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Memori Long-Term Memory

    MemoriLabs/Memori

    Connects Claude Code to Memori Cloud for long-term memory, recalling stored context before substantive replies and saving new context afterward.

    17k GitHub stars~2k tokensUpdated 7 days ago
    Agent WorkflowsAuto-check: notes
  • Picoclaw Skill Creator

    sipeed/picoclaw

    Guidance for creating, updating and reviewing Picoclaw skills, from the SKILL.md structure to organizing bundled scripts, references and assets.

    30k GitHub stars~4.4k tokensUpdated 15 days ago
    Agent WorkflowsAuto-check passed
  • ccc Semantic Code Search

    cocoindex-io/cocoindex-code

    Semantic code search and index management with the ccc CLI: the agent initializes, indexes and queries the project by concept, filtering by language or path.

    2.8k GitHub stars~938 tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed
  • Routing rules for using context-mode MCP tools in Antigravity CLI: sandboxed code runs, file analysis, indexed search and web fetches that keep large output out of the conversation.

    26k GitHub stars~850 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Token Optimizer

    alexgreensh/token-optimizer

    Audit a Claude Code or Codex setup for context-window waste, then fix it and measure the savings.

    2.5k GitHub stars~3.6k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed

More from cwinvestments/memstack

All 87 skills in this repo
  • Memstack SEO Site Audit

    cwinvestments/memstack

    A skill your agent uses when the user says 'SEO audit', 'site audit', 'check SEO', 'audit my site', 'SEO check', 'technical SEO', or is evaluating a website's search engine optimization health, meta…

    423 GitHub stars~3.5k tokensUpdated 13 days ago
    Auto-check passed
  • Memstack SEO Schema Markup

    cwinvestments/memstack

    A skill your agent uses when the user says 'add schema', 'schema markup', 'JSON-LD', 'structured data', 'rich results', 'rich snippets', or is adding or fixing schema.org structured data for better…

    423 GitHub stars~2.7k tokensUpdated 13 days ago
    Auto-check passed
  • Diary

    cwinvestments/memstack

    A skill your agent uses when the user says 'save diary', 'log session', 'wrapping up', or at end of a productive session.

    423 GitHub stars~5k tokensUpdated 13 days ago
    Auto-check passed
  • Echo

    cwinvestments/memstack

    A skill your agent uses when the user references past sessions, asks 'what did we do', 'do you remember', 'last session', 'recall', or 'continue from'.

    423 GitHub stars~1.7k tokensUpdated 13 days ago
    Auto-check passed
  • Familiar

    cwinvestments/memstack

    A skill your agent uses when the user says 'dispatch', 'send familiar', 'split task', or needs work split across parallel CC sessions.

    423 GitHub stars~556 tokensUpdated 13 days ago
    Auto-check passed
  • Forge

    cwinvestments/memstack

    A skill your agent uses when the user says 'forge this', 'new skill', 'create enchantment', or wants to create a MemStack skill.

    423 GitHub stars~505 tokensUpdated 13 days ago
    Auto-check passed

Categories

Questions about Compress

What does Compress do?

A skill your agent uses when the user says 'tokenstack', 'compression', 'token savings', 'proxy status', or asks about context window usage. Compress is an agent skill from cwinvestments/memstack. Use when the user says 'tokenstack', 'compression', 'token savings', 'proxy status', or asks about context window usage.

When should I use Compress?

Compress fits situations like: the user says tokenstack; asks about context window usage.

How do I install Compress in Claude Code?

Run `npx skills add cwinvestments/memstack --skill compress -a claude-code`. Or copy the skill folder (skills/compress in cwinvestments/memstack) into .claude/skills/compress in your project. Claude Code loads it when a task matches its description.

How do I install Compress in Codex?

Run `npx skills add cwinvestments/memstack --skill compress -a codex`. Or copy the skill folder (skills/compress in cwinvestments/memstack) into .agents/skills/compress in your project. Codex loads it when a task matches its description.

Can I use Compress in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add cwinvestments/memstack --skill compress -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/compress, .gemini/skills/compress, .github/skills/compress and .opencode/skills/compress in your project.

What does Compress need to run?

Going by SKILL.md and its folder, Compress needs the command-line tools its instructions call (python and curl). Our summary lists: Python 3.

Does Compress access the network?

SKILL.md contains no URLs. Its commands use curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Compress safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Compress use?

Compress is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Compress use?

About 1.2k tokens (SKILL.md is roughly 5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Compress?

Skills that share tags, products or a category with Compress: Context Mode Output Sandbox (mksglu/context-mode, 26k stars), Memori Long-Term Memory (MemoriLabs/Memori, 17k stars), Picoclaw Skill Creator (sipeed/picoclaw, 30k stars) and ccc Semantic Code Search (cocoindex-io/cocoindex-code, 2.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Compress?

cwinvestments (a GitHub user) maintains it in cwinvestments/memstack, which has 423 GitHub stars. The repository holds 87 skills in this directory. The repository was last updated on September 26, 2026.

Source: cwinvestments/memstack on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.