Agent skill

Contextpilot Savings

by EfficientContext in EfficientContext/ContextPilot

A skill your agent uses when a user asks how many tokens (or how much context/cost) ContextPilot has saved, or wants a ContextPilot savings status/summary inside Hermes Agent — e.g.

MITAuto-check passedAI & LLM Engineering

Install Contextpilot Savings

skills CLI
$ npx skills add EfficientContext/ContextPilot --skill contextpilot-savings -a claude-code

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

GitHub CLI
$ gh skill install EfficientContext/ContextPilot contextpilot-savings --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/EfficientContext/ContextPilot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/contextpilot-savings .claude/skills/contextpilot-savings && 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
contextpilot-savings
GitHub stars
140
Token cost
~1.4k tokens
SKILL.md length
621 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when a user asks how many tokens (or how much context/cost) ContextPilot has saved, or wants a ContextPilot savings status/summary inside Hermes Agent — e.g.

  • Works in 3 steps: Locate the script → Run the reporter → Summarize in plain language
  • A user asks how many tokens (or how much context/cost) ContextPilot has saved
  • SKILL.md covers When to use this skill, Privacy boundary (read this…, How to run it and When there are no savings yet, plus 2 more sections
  • Calls python3

What it does

Contextpilot Savings is an agent skill from EfficientContext/ContextPilot. Use when a user asks how many tokens (or how much context/cost) ContextPilot has saved, or wants a ContextPilot savings status/summary inside Hermes Agent — e.g. "how much did ContextPilot save?", "show ContextPilot token savings", "ContextPilot status", "savings in the last 24h / all time", or "give me the raw savings JSON". This skill runs the metadata-only scripts/contextpilotsavings.py reporter and summarizes its output in plain language. It is read-only and observe-only — it never changes ContextPilot code…

Its SKILL.md is about 1.4k 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 AI & LLM Engineering, covering Plain language and style rules, Prompt engineering and Summarization. The repository describes itself as: Accelerating Long Context LLM Inference with Accuracy-Preserving Context Optimization in SGLang, vLLM, llama.cpp, OpenClaw, RAG, and Agentic AI. The licence is MIT.

When your agent uses it

  • A user asks how many tokens (or how much context/cost) ContextPilot has saved
  • Wants a ContextPilot savings status/summary inside Hermes Agent — e.g

Example prompts

  • “how much did ContextPilot save?”
  • “show ContextPilot token savings”
  • “ContextPilot status”
  • “/contextpilot-savings”

Requirements

  • Python 3

Workflow steps

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

  1. Locate the script
  2. Run the reporter
  3. Summarize in plain language

What it can do on your machine

Read from SKILL.md and the folder at commit b4c8032. 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:

    • python3

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

  • Network

    No URLs in SKILL.md.

    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

Contextpilot Savings loads about 1.4k tokens when it runs. Until then it costs about 188 tokens; SKILL.md has 621 words of instructions outside code blocks.

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

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 EfficientContext/ContextPilot at commit b4c8032, republished under its MIT licence (© EfficientContext). 621 words, ~1,369 tokens.

Download SKILL.mdSave it as .claude/skills/contextpilot-savings/SKILL.md (or your agent's skills folder).
name
contextpilot-savings
description
Use when a user asks how many tokens (or how much context/cost) ContextPilot has saved, or wants a ContextPilot savings status/summary inside Hermes Agent — e.g. "how much did ContextPilot save?", "show ContextPilot token savings", "ContextPilot status", "savings in the last 24h / all time", or "give me the raw savings JSON". This skill runs the metadata-only `scripts/contextpilot_savings.py` reporter and summarizes its output in plain language. It is read-only and observe-only — it never changes ContextPilot code or config, never enables routing/dropping/summarization, never creates cron jobs, branches, or pull requests, and never reads conversation messages, tool outputs, system prompts, reasoning, or raw session ids.
version
1.0.0
author
ContextPilot
license
MIT

ContextPilot Savings (Hermes)

This is a small, read-only skill: when a user wants to know how many tokens ContextPilot has saved, run the lightweight savings reporter and explain the result in plain language. That is the entire job — measure and report, nothing else.

Scope: show savings/status only. This skill never modifies ContextPilot code or config, never enables context routing/dropping/summarization, never schedules background jobs, and never edits the repository or opens code-change requests. If a user wants any of that, this is the wrong tool — stop and tell them so.

When to use this skill

  • "How many tokens did ContextPilot save?"
  • "Show me ContextPilot token savings" / "ContextPilot status".
  • "Savings in the last 24 hours" / "savings all time".
  • "Give me the raw savings data / JSON."

Privacy boundary (read this first)

The only thing this skill is allowed to read is the metadata-only telemetry file (~/.hermes/contextpilot/telemetry.jsonl), and it reads it only through scripts/contextpilot_savings.py. That file contains nothing but numeric counters (timestamps, chars saved, tokens saved).

Do not, under any circumstances:

  • read ~/.hermes/state.db, conversation messages, or message content,
  • read system prompts, skill prompts, or reasoning fields,
  • read raw tool-call payloads or tool outputs,
  • read or print raw session ids.

If you are ever tempted to inspect any of the above to "explain" the savings, don't — the script's metadata summary is the complete, safe answer.

How to run it

Step 1 — Locate the script

Use whichever of these exists (check in this order):

  1. scripts/contextpilot_savings.py — when you are in a ContextPilot repo or plugin checkout (current working directory).
  2. ~/.hermes/plugins/ContextPilot/scripts/contextpilot_savings.py — when ContextPilot was installed as a Hermes plugin.

Pick the first one that exists and use that path as <script> below.

Step 2 — Run the reporter

Default (last 24 hours):

bash
python3 <script> --since-hours 24

Vary the command to match the request:

  • All time — if the user asks for total/lifetime savings:

    bash
    python3 <script> --all-time
  • A different window — e.g. last hour:

    bash
    python3 <script> --since-hours 1
  • JSON / raw data — if the user asks for machine-readable output, raw data, or to feed a dashboard:

    bash
    python3 <script> --format json

    (Combine with --all-time or --since-hours N as needed.)

The script prints events, chars saved, telemetry tokens saved, the time window, and average tokens per event.

Show full SKILL.md (272 more words)Show less
Step 3 — Summarize in plain language

Read the script's output and give the user a short, friendly summary: roughly how many tokens ContextPilot saved, over what window, and the event count. If they asked for JSON, show the JSON and add a one-line readout. Do not invent numbers — only report what the script printed.

When there are no savings yet

If the script reports no telemetry file or zero events in the window, tell the user (in plain language) to:

  1. Enable ContextPilot in Hermes (hermes plugins → toggle contextpilot).
  2. Restart Hermes.
  3. Repeat a workload that reads the same content more than once (e.g. read a file, then read it again) — savings only fire when content repeats across turns.

You can also suggest --all-time to widen the window in case recent activity just fell outside the last 24 hours.

Installation note

For normal use, installing or copying this skill does not require a --force flag — only reach for --force if a skill installer reports an existing-name collision you intend to overwrite. The skill itself runs a single read-only Python command; it needs no special privileges.

Out of scope (do not do these)

This skill is deliberately narrow. It must not:

  • modify ContextPilot source code or configuration,
  • enable or tune context routing, dropping, or summarization,
  • schedule background or recurring runs,
  • edit the repository, run a test/merge workflow, or open code-change requests,
  • train or evaluate any router, or run a propose/apply improvement loop.

If the user wants deeper monitoring (state.db metadata, opportunity scanning), point them at docs/guides/hermes-monitor.md. For integration mechanics, point them at docs/guides/hermes.md. This skill only answers "how much did ContextPilot save?".

© EfficientContext, 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/contextpilot-savings of EfficientContext/ContextPilot.

Open the folder on GitHubat commit b4c8032

Compare with similar skills

Contextpilot Savings 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.

Contextpilot Savings compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Contextpilot Savings this skillEfficientContext/ContextPilot140—~1.4kAutomated safety check: PassMIT
Quark Onnx Routeramd/Quark181—~2.7kAutomated safety check: PassMIT
Quark Torch Routeramd/Quark181—~1.9kAutomated safety check: PassMIT
Quark Torch Routeramd/Quark181—~1.8kAutomated safety check: PassMIT
Asd Ste100danyuchn/asd-ste100-skill3.9k—~4.1kAutomated safety check: PassMIT
Ideer Daily Paper ChatbotAI45Lab/iDeer416—~3kAutomated safety check: NotesAGPL-3.0

Similar skills

  • Route Quark ONNX user goals to the correct atomic skill. An agent skill from amd/Quark.

    181 GitHub stars~2.7k tokensUpdated 10 days ago
    AI & LLM EngineeringAuto-check passed
  • Route Quark user goals to the correct atomic skill or workflow.

    181 GitHub stars~1.9k tokensUpdated 10 days ago
    AI & LLM EngineeringAuto-check passed
  • Route Quark user goals to the correct atomic skill or workflow.

    181 GitHub stars~1.8k tokensUpdated 10 days ago
    AI & LLM EngineeringAuto-check passed
  • Asd Ste100

    danyuchn/asd-ste100-skill

    A skill your agent uses when English text must be parsed without a human to resolve ambiguity — tool descriptions, error messages, inter-agent instructions, system prompts, status reports — and…

    3.9k GitHub stars~4.1k tokensUpdated 3 days ago
    Writing & ContentAuto-check passed
  • Use iDeer as a daily paper-reading workflow for chatbot-first users such as Codex, Gemini, or ChatGPT.

    416 GitHub stars~3k tokensUpdated 2 mo ago
    AI & LLM EngineeringAuto-check: notes
  • Vllm Rlt Review PR

    ThinkFlowLab/vllm-rlt

    Review PRs and local changes for hsliuustc0106/vllm-rlt: Ouro engine and KV correctness, serving behavior, and BF16 accuracy/speed evidence.

    138 GitHub stars~1.1k tokensUpdated 7 days ago
    AI & LLM EngineeringAuto-check passed

Questions about Contextpilot Savings

What does Contextpilot Savings do?

A skill your agent uses when a user asks how many tokens (or how much context/cost) ContextPilot has saved, or wants a ContextPilot savings status/summary inside Hermes Agent — e.g. Contextpilot Savings is an agent skill from EfficientContext/ContextPilot.g.

When should I use Contextpilot Savings?

Contextpilot Savings fits situations like: A user asks how many tokens (or how much context/cost) ContextPilot has saved; wants a ContextPilot savings status/summary inside Hermes Agent — e.g.

How do I install Contextpilot Savings in Claude Code?

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

How do I install Contextpilot Savings in Codex?

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

Can I use Contextpilot Savings 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 EfficientContext/ContextPilot --skill contextpilot-savings -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/contextpilot-savings, .gemini/skills/contextpilot-savings, .github/skills/contextpilot-savings and .opencode/skills/contextpilot-savings in your project.

What does Contextpilot Savings need to run?

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

Does Contextpilot Savings access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Contextpilot Savings 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 Contextpilot Savings use?

Contextpilot Savings is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Contextpilot Savings use?

About 1.4k tokens (SKILL.md is roughly 5.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 Contextpilot Savings?

Skills that share tags, products or a category with Contextpilot Savings: Quark Onnx Router (amd/Quark, 181 stars), Quark Torch Router (amd/Quark, 181 stars), Quark Torch Router (amd/Quark, 181 stars) and Asd Ste100 (danyuchn/asd-ste100-skill, 3.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Contextpilot Savings?

EfficientContext (a GitHub organization) maintains it in EfficientContext/ContextPilot, which has 140 GitHub stars. The repository was last updated on October 2, 2026.

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