Explain Simply — Development skill for Claude Code

Explain Simply

English | [Korean](README.ko.md)

Explain Simply turns dense technical reports into plain-language explanations that preserve facts, uncertainty, risk, and the next decision.

It ships as one skills-only plugin for both Claude Code and Codex. It contains no hooks, executable scripts, MCP servers, network requests, or automatic update checks.

Install

Claude Code

/plugin marketplace add ssauma/explain-simply
/plugin install explain-simply@explain-simply

Invoke it explicitly with `/explain-simply:explain-simply`, or ask Claude to explain a report in plain language.

Codex

codex plugin marketplace add ssauma/explain-simply
codex plugin add explain-simply@explain-simply

Start a new Codex session, then invoke `$explain-simply` or ask for a plain-language explanation.

Automatic invocation

The skill is designed to be discovered from natural follow-ups such as:

• Explain this in plain English.
• Make this easier to understand.
• Can you say that in normal words?
• What does that actually mean?
• Explain it so I can understand it.

What it preserves

• The current state and why it matters
• Decision-relevant numbers, thresholds, dates, and scope
• The boundary between confirmed facts, inference, and unknowns
• Remaining risks, blockers, and the next action or decision
• The language and level of detail requested by the reader

Repository layout

.agents/plugins/marketplace.json          Codex marketplace
.claude-plugin/marketplace.json           Claude Code marketplace
plugins/explain-simply/
  .claude-plugin/plugin.json              Claude Code manifest
  .codex-plugin/plugin.json               Codex manifest
  skills/explain-simply/SKILL.md          Shared skill instructions
evals/cases.md                            Behavioral acceptance cases

Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for development and release checks.

Use the repository's issue forms for bugs and r