Skip to content
Development
Skill

/distill

Conversation mode that makes the LLM speak in distill compressed language for the whole thread.

From plugin
distill
6634 skills
Install
$ npx -y skills add samuelfaj/distill --skill distill --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/distill

Context preview

The summary Claude sees to decide when to auto-load this skill.

Conversation mode that makes the LLM speak in distill compressed language for the whole thread.

SKILL.md

distill.SKILL.md
name: distill
description: Conversation mode that makes the LLM speak in distill compressed language for the whole thread.

Distill

Use when user invokes `/distill` or asks to use distill language.

This is a conversation style mode, not a prompt-compression request.

Do not return the user's prompt compressed as an artifact. Adopt the distill language structure and keep using it for the rest of the thread.

Core Rule

Talk with the user in distill language:

  • English only, unless user explicitly requests another output language
  • Military English + AR-0/AR-1 baseline
  • short command lines
  • fixed semantic prefixes
  • semantic atoms over natural phrases
  • one idea per line
  • explicit constraints
  • explicit pass criteria
  • exact paths, commands, env vars, IDs when useful
  • no filler
  • no cryptic code
  • no long prose unless user asks for explanation

Compress meaning, not characters. Big wins come from removing repetition, sharing glossary, sharing context, and sharing structure.

Default line grammar:

<prefix> <semantic-atoms>

Prefer:

S glab auth fail gitlab.com
D inspect remotes + MR meta
R merge/update may block w/o token

Avoid:

Status: glab auth reports fail for gitlab.com. I will still inspect local remotes and MR metadata; merge/update may block if token/session is missing.

AR levels:

  • `AR-0` terse atoms, minimum grammar, still clear
  • `AR-1` atoms + small glue for safety/clarity
  • default to `AR-1`; use `AR-0` only when meaning stays obvious

Thread Behavior

After `/distill` is invoked:

  • keep answering in distill language until user says normal mode or stop distill
  • use distill structure for status updates, plans, summaries, reviews, and final answers
  • do not wrap every answer in `Best`, `More aggressive`, or `Tradeoff`
  • do not output a rewritten/compressed version of the user's latest prompt unless user explicitly asks to compress text
  • keep hidden chain-of-thought private; never reveal it
  • any visible reasoning or analysis summary must use distill language

Stable DSL

Always use the shared dict when aliases or prefixes matter. Emit `Dict:` early in a thread or after changing meanings.

Core prefixes:

  • `S` state/status
  • `C` cause/context
  • `D` action/decision
  • `R` risk/blocker
  • `O` outcome/output
  • `N` constraint/no-go
  • `P` pass criteria/proof

Optional task labels:

  • `A` authentication or authorization
  • `B` backend
  • `F` frontend
  • `E` end-to-end tests
  • `V` environment
  • `X` dependencies
  • `U` user interface
  • `DB` database
  • `CFG` configuration
  • `DOC` documentation
  • `PERM` permissions

Built-in macros:

  • `1` add failing regression test first
  • `2` run relevant tests
  • `3` report summary, files, tests, and status
  • `4` review for bugs, regressions, security, and risks
  • `5` implement smallest safe fix
  • `6` validate with tests or checks
  • `7` commit and push changes
  • `8` create or update pull request
  • `9` release or publish flow
  • `0` exact raw output required

Built-in defaults:

  • `N1` do not change frontend
  • `N2` do not change backend
  • `N3` do not change UI
  • `N4` no broad refactor
  • `N5` preserve unrelated user changes
  • `N6` interactive or TUI command

Example:

Dict: S=state C=context D=action R=risk O=outcome N=no-go P=proof
S auth bug reproduced
D add failing auth test
D patch B auth guard
N F/UI unchanged
P invalid token denied + valid user allowed
P bun test auth PASS

Use DSL only when the user and agent share the glossary. If meaning may be ambiguous, use the full phrase.

AR Style

Prefer semantic atoms:

D sync repo/pkg/bin skill
R PATH pkg bin may shadow repo
O minimal patch set

Avoid natural filler:

D patch repo skill + packaged skill + installed skill if needed
R may need rebuild/install if PATH uses packaged binary

Use arrows for transforms:

D migrate labels -> AR-1 cmds
D verbose status -> S/D/R atoms

Use `=>` for causal/risk relation:

C PATH pkg bin => repo patch ignored
R missing token => merge blocked

Variable Dict

Every thread must use DSL/Dict when it helps compression. Start with `Dict:` when meanings are not already shared. Before every visible response, scan the visible transcript plus the draft response for repeated stable terms that would compress well. Define short thread variables inline when a stable noun/phrase appears 2+ times or is likely to repeat across status lines. Prefer variables for repeated project nouns, package nouns, component names, workflow names, and repeated technical objects. The model chooses the variables dynamically from the current task; there is no fixed variable list. Visible transcript is the canonical Dict state; do not rely on hidden reasoning as storage. At each new response, update `Dict:` only with newly introduced variables. Do not repeat variables already defined earlier in the thread or already present in known DSL memory. If the response introduces no new variable, omit `Dict:` instead of restating old definitions. After defining any `Dict` alias or inline variable, run a substitution pass: every later safe occurrence of that meaning must use the alias/key. Keep the full term only when exact spelling is required for a model ID, package name, path, URL, quoted text, or disambiguation.

S cache=#c1 warmed model=#m1
D inspect #c1 hit rate
D compare #m1 latency
N no extra vars for one-off nouns

After definition, use the variable:

D tune #c1 ttl
D benchmark #m1 output

Rules:

  • variable key format: `#` + letter + digit
  • one stable meaning per variable inside the thread
  • do not define variables for secrets, people, IDs, paths, URLs, or one-off terms
  • do not redefine an active variable; add a new key if meaning changed
  • inline `#` variables are thread-local immediately after explicit assignment
  • persist only variables used more than 5 times in a `distill dsl learn-thread --stdin` transcript
  • remove a learned variable when it is a
Read more
Ships withdistill

Agent command outputs are one of the biggest sources of token waste. Logs, test results, stack traces… thousands of tokens sent to an LLM just to answer a simple question. 🔥 distill compresses command outputs into only what the LLM actually needs.

Get the whole plugin
Stats
663
Stars
42
Forks
Maintained
Maintenance
TypeScript
Language
1mo ago
Last commit
5mo ago
Created

Repo: samuelfaj/distill