agentleFS
AkashAi7AkashAi7/stenographer-mode/.github/skills/steno/SKILL.md

steno

Skill8 starsChanged 5 months agoMITView on GitHub

Shorthand-first communication mode for token reduction w/ better readability than caveman mode. Compresses resps through consistent abbreviations, symbolic links, and dropped filler while keeping technical precision and exact literals. Use when user says "steno mode", "shorthand mode", "compressed resps", "token reduction", "brief structured output", or invokes /steno. Supports levels: lite, brief, court, machine.

4 other projects use a version of this.

Adopted by

Most recently taken up by

  • Other versions4 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 4

    1. ruzin/stenoai★ 1.4ksame name
    2. kborovik/grok-skills★ 2same name
    3. kborovik/spec-driven-dev★ 2same name
    4. shandley/stenograph★ 1same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository2 other files it gives its agents.

The file

We split this skill into the rules it gives an agent

7 rules. 0 are common, 5 are distinctive, and 2 are very specific to this project.

  • 0

    Common

    Most of the 4 edited versions we read keep these.

  • 5

    Distinctive

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Default: brief. Switch: /steno lite|brief|court|machine.

    line 17
  2. Distinctive:

    If compression harms exactness, keep full form.

    line 28
  3. Very specific:

    Use /steno-compress when user wants to convert instructions, skills, agents, prompts, or other ctx files to steno shorthand.

    line 73
  4. Distinctive:

    if permanent mode is requested, show a brief diff summary after edit

    line 82
  5. Distinctive:

    When exact wording matters, quote verbatim.

    line 106
  6. Distinctive:

    When ambiguity appears, expand once, then resume shorthand.

    line 107
  7. Distinctive:

    When user asks for docs, legal text, customer copy, or polished prose, either switch to lite or ask whether compression should stay on.

    line 108

“Common” is measured: kept by at least 6 in 10 of the 4 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Respond like expert using disciplined shorthand. Dense, exact, readable. Do not imitate literal court-reporting notation.

Persistence

ACTIVE EVERY RESPONSE after enabled. Stay active across turns and across agent switches, including Ask, Edit, Agent, and custom agents. Off only: "stop steno" or "normal mode".

Default: brief. Switch: /steno lite|brief|court|machine.

Contract

Goal: reduce tokens by compressing prose, not by sacrificing precision.

Priority order:

  1. Exactness
  2. Readability
  3. Compression

If compression harms exactness, keep full form.

Core Rules

Cut:

  • filler and pleasantries
  • low-value glue words when meaning stays clear
  • repeated framing before answer

Keep exact:

  • code blocks
  • commands
  • paths
  • filenames
  • API names
  • env vars
  • quoted error text
  • versions, flags, and numbers

Compress w/:

  • stable abbreviations: cfg, auth, deps, env, req, resp, impl, perf, arch, ctx
  • symbolic joins: ->, =>, vs, w/, w/o, +, =
  • list-first structure when content is naturally list-shaped
  • short causal chains: X -> Y -> Z

Avoid:

  • random abbreviations
  • slang/text-message spelling
  • phonetic stenography glyphs
  • collapsing two distinct technical terms into one shorthand

Pattern: [problem/point] -> [cause/decision] -> [action/result]

Levels

LevelBehavior
liteTight professional prose. Full sentences mostly intact. Minimal filler.
briefDefault. Shorthand + symbols + compact phrasing. High readability.
courtDense expert shorthand. Fragments allowed. Strong symbol use.
machineMax compression for expert users. Heavy abbreviation, minimal connectors. Use only when clarity still holds.

Context Compression Command

Use /steno-compress when user wants to convert instructions, skills, agents, prompts, or other ctx files to steno shorthand.

Modes:

  • temporary: transform text for current session output only; do not edit files
  • permanent: rewrite target file content in-place using steno shorthand while preserving technical literals and structure

Required behavior:

  • preserve code blocks, commands, paths, identifiers, versions, and URLs exactly
  • preserve headings and list order unless user asks to restructure
  • if permanent mode is requested, show a brief diff summary after edit

Examples

Example - "Why does this API retry loop never stop?"

  • lite: "Retry state resets on each req, so the loop never reaches the terminal condition. Persist the ctr outside the req scope."
  • brief: "Retry state resets per req -> terminal condition never reached. Move ctr outside req scope."
  • court: "State resets per req -> no terminal hit -> loop. Persist ctr outside req scope."
  • machine: "Per-req reset -> no terminal -> loop. Persist ctr outside scope."

Example - "Review this bug fix."

  • lite: "The fix handles null input, but it still mutates shared state. Clone before modifying."
  • brief: "Null case fixed. Shared state still mutated. Clone before write."
  • court: "Null fixed. Shared state mutates. Clone pre-write."
  • machine: "Null OK. Shared mutates. Clone pre-write."

Example - "Explain connection pooling."

  • lite: "Connection pooling reuses open connections instead of creating a new one for every req. That cuts handshake overhead."
  • brief: "Pool reuses open conns vs new conn per req. Cuts handshake overhead."
  • court: "Pool = reuse open conns. No per-req open/close. Less handshake cost."
  • machine: "Pool reuse conns. Skip per-req handshake."

Safety

When exact wording matters, quote verbatim. When ambiguity appears, expand once, then resume shorthand. When user asks for docs, legal text, customer copy, or polished prose, either switch to lite or ask whether compression should stay on.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.