hermes-context-optimization

Diagnose and reduce Hermes startup prompt size, tool-schema overhead, and compression behavior.

115|9|Updated Aug 5, 2026
One-click install
npx skills add https://github.com/AtlasOmnia/donna-starter --skill hermes-context-optimization-atlasomnia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hermes-context-optimization
Source: https://github.com/AtlasOmnia/donna-starter/tree/main/skills/autonomous-ai-agents/hermes-context-optimization
Command: npx skills add https://github.com/AtlasOmnia/donna-starter --skill hermes-context-optimization-atlasomnia

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Hermes sessions can start with tens of thousands of tokens consumed by tool schemas, skill indexes, memory blocks, and profile data before the user types anything, and compression can silently fall back to expensive models. This Skill provides measured workflows to inspect, attribute, and shrink that context overhead. ## Core Features & Use Cases - Native payload inspection: Use hermes prompt-size and /usage to break the first-turn payload into system prompt, tool schemas, skills, MCP, and memory categories. - Skill and tool pruning: Query state.db for actually-used skills, diff against installed ones, and safely disable unused entries in config.yaml with YAML verification. - Compression debugging: Trace auxiliary.compression routing, detect silent fallback to the main model, and size summary models correctly for large sessions. - Use Case: A user notices every new Hermes session costs ~22k tokens before any work happens; this Skill walks them through measuring the composition, disabling 84 unused skills, and fixing a misrouted compression provider. ## Quick Start Ask the assistant to measure what Hermes loads on the first turn of a fresh session and identify the largest reducible contributors to the startup prompt.

Frequently Asked Questions about hermes-context-optimization

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I measure what Hermes sends on the first message of a session?

Run `hermes prompt-size --platform cli` for an offline breakdown of system prompt, skills, memory, and tool-schema bytes, then use `/usage` after the first turn for the live request composition. Both use a chars/4 estimate, so treat provider-reported input tokens as the exact figure.

How do I reduce Hermes startup prompt tokens?

Prune unused skills first by querying state.db for skill_view usage and adding unused names to skills.disabled in config.yaml, then restart the gateway. Tool schemas dominate after pruning, so further savings require disabling toolsets or using a tool router.

Why is Hermes compression using my main model instead of the local summary model?

The auxiliary.compression config block overrides compression.summary_model, and a timeout or invalid response triggers silent fallback to the main model for the rest of the session. Check gateway logs for fallback messages and align auxiliary.compression with your intended endpoint.

Can Snapcompact-style image context replace the Hermes startup prompt?

Only for reference material like memory, profiles, and skill indexes, at roughly a 67% token reduction. Tool schemas and authoritative system rules must remain structured text because providers need callable JSON schemas and reliable system-channel instructions.

What should I do when Hermes says context length exceeded and cannot compress further?

Treat it as session-scoped: stop retrying /compress, preserve the old session, and start a fresh session with /new plus a compact handoff of verified state. Do not use /resume or /topic to reload the oversized transcript.