Agent skill

WTF Plain-Language Explainer

by EveryInc in EveryInc/compound-engineering-plugin

Explains the last message, or a file, link or passage you give it, in plain language so you can say what it means and what you must decide without rereading the source.

MITAuto-check passedWriting & Content

Install WTF Plain-Language Explainer

skills CLI
$ npx skills add EveryInc/compound-engineering-plugin --skill wtf -a claude-code

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

GitHub CLI
$ gh skill install EveryInc/compound-engineering-plugin wtf --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/EveryInc/compound-engineering-plugin.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/wtf .claude/skills/wtf && 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
wtf
GitHub stars
25k
Token cost
~549 tokens
SKILL.md length
313 words
Files
2
Skills in repo
37
Repo updated
First seen
Licence
MIT

At a glance

Explains the last message, or a file, link or passage you give it, in plain language so you can say what it means and what you must decide without rereading the source.

  • You did not understand the agent's last reply
  • SKILL.md covers What to explain and How to explain
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • A long document, link or pasted passage needs a short plain explanation

What it does

When you invoke it because you did not follow something, the agent decides the target from what you passed: nothing means its own most recent message, a path or link is read first, a pasted passage is used as is, and a short pointer such as a step number narrows it to that part of the conversation. If the target is still unclear, it asks one short question instead of guessing.

The explanation opens with the point in a sentence or two, then says what it means for you: what happened, what state things are in and what you need to decide or do. It explains rather than rewrites, stays shorter than the source, uses everyday words while keeping needed technical terms, file names, commands and values, and never sounds more certain or more positive than the source. It flags vague or self-contradicting sources, corrects the agent's own earlier mistakes, and avoids forced analogies or talking down.

When your agent uses it

  • You did not understand the agent's last reply
  • A long document, link or pasted passage needs a short plain explanation
  • You need to know what a message wants you to decide or do

Example prompts

  • “/wtf explain the migration part of your last message”
  • “Explain this outage report in plain language: ./reports/outage.md”
  • “I didn't follow step 3, so say it again simply.”

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md.

    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

WTF Plain-Language Explainer loads about 549 tokens when it runs. Until then it costs about 69 tokens; SKILL.md has 313 words of instructions outside code blocks.

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

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 EveryInc/compound-engineering-plugin at commit cef001f, republished under its MIT licence (© EveryInc). 313 words, ~549 tokens.

Download SKILL.mdSave it as .claude/skills/wtf/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
wtf
description
Explain the last message, or a supplied file, link, or passage, in plain language a person follows on the first read. Use when the user invokes wtf because they did not follow something. Use ce-explain to investigate how or why code works, and ce-noslop to rewrite prose.
disable-model-invocation
true
argument-hint
[file path, URL, pasted text, or which part lost you; blank for the last message]

wtf

The user did not follow something. Explain it the way you would to a smart colleague who was not in the room.

Done: the user can say what the source means and what, if anything, they need to decide or do, without going back to the source.

What to explain

The text the user passed with the invocation decides the target:

  • Nothing passed: your most recent message.
  • A file path or a link: read it, then explain it.
  • A pasted passage: that passage.
  • A short pointer such as "the migration part" or "step 3": only that part of the conversation.

If the target is still unclear, ask one short question instead of guessing.

How to explain

  • Open with the point in one or two sentences: what this says and why the user should care. Write no preamble and no apology for the earlier wording.
  • Then say what it means for them: what happened, what state things are in, and anything they need to decide or do.
  • Explain the source; do not rewrite it. The explanation is shorter than the source because it leaves out whatever the user does not need in order to understand it or act on it. Do not walk a document section by section.
  • Use everyday words. When a technical term matters, keep it and say what it means once, in passing. Keep the exact file names, commands, and values the user will need to use.
  • Keep everything that changes what the user would do: failures, caveats, open questions, and requests. The explanation must not sound more positive or more certain than the source.
  • Add no claims the source does not make. If the source is vague or contradicts itself, say so. If re-reading your own message shows it was wrong, say that and correct it.
  • Plain does not mean childish. Do not force analogies, cheerlead, or talk down.

© EveryInc, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/wtf of EveryInc/compound-engineering-plugin.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit cef001f

Compare with similar skills

WTF Plain-Language Explainer 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.

WTF Plain-Language Explainer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
WTF Plain-Language Explainer this skillEveryInc/compound-engineering-plugin25k—~549Automated safety check: PassMIT
Reminddavidondrej/skills4.1k—~266Automated safety check: PassMIT
Science Communicationbrycewang-stanford/Auto-Empirical-Research-Skills4.5k—~3.1kAutomated safety check: PassCustom licence
Reportkv0906/pm-kit138—~1.7kAutomated safety check: NotesMIT
Stakeholder Summarytestdouble/han279—~6.3kAutomated safety check: PassMIT
Contextpilot SavingsEfficientContext/ContextPilot140—~1.4kAutomated safety check: PassMIT

Similar skills

  • Remind

    davidondrej/skills

    Rewrite the last response simpler and shorter in plain English, prefixed with a 3-5 sentence TLDR of the conversation so far.

    4.1k GitHub stars~266 tokensUpdated today
    Writing & ContentAuto-check passed
  • Science Communication

    brycewang-stanford/Auto-Empirical-Research-Skills

    Translating technical findings for non-technical audiences. An agent skill from brycewang-stanford/Auto-Empirical-Research-Skills.

    4.5k GitHub stars~3.1k tokensUpdated 2 days ago
    Writing & ContentAuto-check passed
  • Report

    kv0906/pm-kit

    Executive briefing in plain language — report to me like I'm the CEO or product owner.

    138 GitHub stars~1.7k tokensUpdated 3 mo ago
    Writing & ContentAuto-check: notes
  • Stakeholder Summary

    testdouble/han

    Produces a plain-language stakeholder summary from an existing feature specification, for sharing with non-technical stakeholders before implementation kicks off.

    279 GitHub stars~6.3k tokensUpdated 6 days ago
    Writing & ContentAuto-check passed
  • Contextpilot Savings

    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.

    140 GitHub stars~1.4k tokensUpdated 4 days ago
    AI & LLM EngineeringAuto-check passed
  • Client Report Narratives

    irinabuht12-oss/marketing-skills

    Takes your raw campaign performance data and writes the executive summary paragraph that goes at the top of the report.

    3.8k GitHub stars~665 tokensUpdated 13 days ago
    Marketing & SEOAuto-check passed

More from EveryInc/compound-engineering-plugin

All 37 skills in this repo
  • Compound Learning Writer

    EveryInc/compound-engineering-plugin

    Records one solved and verified problem as a durable learning in the repository, but only when the reasoning is not already clear from the final code, tests or docs.

    25k GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Compound Learnings Refresh

    EveryInc/compound-engineering-plugin

    Audits a repo's stored learnings against the current codebase, fixes stale, overlapping or superseded docs and reports on every document.

    25k GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Compound Engineering Prototype

    EveryInc/compound-engineering-plugin

    Builds a throwaway prototype at just the fidelity needed to settle a specific how-it-should-work-or-feel question, before committing to an approach other work will treat as fixed.

    25k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Compound Engineering Setup

    EveryInc/compound-engineering-plugin

    Checks Compound Engineering plugin health and repo-local config, or scaffolds a Compound Pack when you ask for one by id.

    25k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • PR Babysitter

    EveryInc/compound-engineering-plugin

    Watches an open GitHub pull request over time, routing review comments and CI failures to other skills until the PR is ready to merge.

    25k GitHub stars~2k tokensUpdated today
    Auto-check passed
  • CE Brainstorm

    EveryInc/compound-engineering-plugin

    Turns a vague or ambitious feature idea into a requirements-only plan through dialogue with you, sized to the work, before any code is written.

    25k GitHub stars~1.9k tokensUpdated today
    Auto-check passed

Questions about WTF Plain-Language Explainer

What does WTF Plain-Language Explainer do?

Explains the last message, or a file, link or passage you give it, in plain language so you can say what it means and what you must decide without rereading the source. When you invoke it because you did not follow something, the agent decides the target from what you passed: nothing means its own most recent message, a path or link is read first, a pasted passage is used as is, and a short pointer such as a step number narrows it to that part of the conversation. If the target is still unclear, it asks one short question instead of guessing.

When should I use WTF Plain-Language Explainer?

WTF Plain-Language Explainer fits situations like: you did not understand the agent's last reply; A long document, link or pasted passage needs a short plain explanation; you need to know what a message wants you to decide or do.

How do I install WTF Plain-Language Explainer in Claude Code?

Run `npx skills add EveryInc/compound-engineering-plugin --skill wtf -a claude-code`. Or copy the skill folder (skills/wtf in EveryInc/compound-engineering-plugin) into .claude/skills/wtf in your project. Claude Code loads it when a task matches its description.

How do I install WTF Plain-Language Explainer in Codex?

Run `npx skills add EveryInc/compound-engineering-plugin --skill wtf -a codex`. Or copy the skill folder (skills/wtf in EveryInc/compound-engineering-plugin) into .agents/skills/wtf in your project. Codex loads it when a task matches its description.

Can I use WTF Plain-Language Explainer 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 EveryInc/compound-engineering-plugin --skill wtf -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/wtf, .gemini/skills/wtf, .github/skills/wtf and .opencode/skills/wtf in your project.

What does WTF Plain-Language Explainer need to run?

SKILL.md names no scripts, command-line tools or credentials: WTF Plain-Language Explainer is instructions for the agent only.

Does WTF Plain-Language Explainer 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 WTF Plain-Language Explainer 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 WTF Plain-Language Explainer use?

WTF Plain-Language Explainer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does WTF Plain-Language Explainer use?

About 549 tokens (SKILL.md is roughly 2.2k 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 WTF Plain-Language Explainer?

Skills that share tags, products or a category with WTF Plain-Language Explainer: Remind (davidondrej/skills, 4.1k stars), Science Communication (brycewang-stanford/Auto-Empirical-Research-Skills, 4.5k stars), Report (kv0906/pm-kit, 138 stars) and Stakeholder Summary (testdouble/han, 279 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains WTF Plain-Language Explainer?

EveryInc (a GitHub organization) maintains it in EveryInc/compound-engineering-plugin, which has 25,412 GitHub stars. The repository holds 37 skills in this directory. The repository was last updated on October 7, 2026.

Source: EveryInc/compound-engineering-plugin on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.