hush-compress

Solid

Compresses a memory file (CLAUDE.md, project notes, preferences) into hush's own dev-shorthand voice to cut input tokens every session it's loaded. Never touches the original file — writes a sibling file for the user to review and swap in manually. A mechanical verifier checks that headings, code blocks, URLs, paths, and inline code all survived.

AI & Automation 27 stars 3 forks Updated 4 days ago MIT

Install

View on GitHub

Quality Score: 88/100

Stars 20%
48
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# hush:hush-compress Shrinks a memory file's word count using hush's own voice — the same "Word economy" rules the output style already applies to conversation — so every future session that loads this file pays fewer input tokens for it. Never writes to the original. ## 1. Refuse before reading, if the path matches any of `.env` (or `.env.*`), `.netrc`, `credentials*`, `secrets*`, `passwords*`, `id_rsa`/`id_ed25519` (or `.pub`), `authorized_keys`, `known_hosts`, any `*.pem/*.key/*.p12/*.pfx/*.crt/*.cer/*.jks/*.keystore/*.asc/*.gpg`, or any path containing a `.ssh/`, `.aws/`, `.gnupg/`, or `.kube/` component. Tell the user why and stop. Do not read the file. These are exactly the kinds of files that must never reach a model call. ## 2. Read the file, refuse if empty If the file is empty or whitespace-only after reading, say so and stop — nothing to compress. ## 3. Compress the body, not the whole file If the file starts with YAML frontmatter (`---` ... `---`), leave it completely untouched — copy it verbatim into the output. Compress only the body below it. Apply hush's own word economy — see `output-styles/hush.md`: - Say it in the fewest words that stay understandable. Before keeping a sentence, ask: can this lose a word without losing a fact? If yes, cut it. - Default to fragments, not sentences. Drop articles, hedges, and connective tissue a reader fills in on their own. - This is dev-shorthand density, not broken grammar: grammar stays correct where it's present...

Details

Author
V-Songbird
Repository
V-Songbird/hush
Created
3 weeks ago
Last Updated
4 days ago
Language
JavaScript
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category