Clear Explain — Development skill for Claude Code
Explain one CLEAR-100 rule: what it catches, why it exists, the fix, and a before-and-after.
How to install Clear Explain
Installs to ~/.claude/skills/eugeniughelbur-clearmode-clear-explain/SKILL.md
mkdir -p ~/.claude/skills/eugeniughelbur-clearmode-clear-explain && curl -fsSL https://raw.githubusercontent.com/eugeniughelbur/clearmode/HEAD/commands/clear-explain.md -o ~/.claude/skills/eugeniughelbur-clearmode-clear-explain/SKILL.md Restart Claude Code, or start a new session, for it to be picked up.
What Clear Explain does
description: Explain one CLEAR-100 rule: what it catches, why it exists, the fix, and a before-and-after. Use when a finding looks wrong or a rule needs a defense.
/clear-explain
Explain a rule, or defend it.
Steps
- Run
python3 scripts/clearcheck.py --explain. Never paraphrase a rule from memory. - Give the reason first, then the fix, then the before-and-after.
- If the user thinks the rule is wrong on their line, decide honestly:
- The rule is right: show the
Alternatives in Development
- Pair Verify — Use after you fix a bug and before you claim it fixed — it spawns ONE skeptic sibling session via CCC that mus 130 ★
- Burn — SLO burn rate — multi-window alerting that catches budget exhaustion before it happens 83 ★
- Sc Explain — Provide clear explanations of code, concepts, and system behavior with educational clarity 55 ★
Full documentation available on GitHub
View Source RepositoryRelated Skills
Propagate Doctor
Diagnose the propagation setup end to end when something looks wrong, or after changing where files live
Preflight
24-tool MCP server that catches vague prompts before they cost 2-3x in wrong→fix cycles. 12-category scorecard
Report Draft
Draft a HackerOne bug bounty report from a validated finding. Only invoke this after a full end-to-end PoC exi
Thumbgate Guard
Turn the last agent mistake into a hard prevention rule the agent cannot bypass. Use after a bad tool call, a
Clear Check
Score a file or pasted text against CLEAR-100 on four axes (Plain, Human, Structured, Dense) and list every fi
Dark Mode Specialist
Use when dark mode looks wrong. Pure black surfaces, elevation that disappears, brand colours that vibrate aga
Related Agents
Bd Diagnose
Diagnoses why a run broke or looks wrong — NaN, blow-up, a failed prediction, a strange plot shape. Needs hypo
Fix Diff Reviewer
Read-only reviewer for audit fix-round commits. Scoped to the diff between round-start and HEAD, plus any path
Tp Session Restorer
PROACTIVELY use this as the FIRST step after /clear, compaction, or a fresh window when a recent session_snaps