← ClaudeAtlas

explain-to-melisted

Explain concepts clearly in the treq voice: direct, declarative prose for a peer engineer, grounded in Orwell's rules for plain English and ASD-STE100 (Simplified Technical English), with house banlists for buzzwords, marketing language, and AI writing tells (em dashes, "not just X but Y", rule-of-three padding, "it's important to note"). Use when the user asks to explain or clarify something, when writing or revising inline code comments, when drafting explanatory documentation, or whenever prose must teach a reader. The writing skill depends on this skill for voice and banlists.
treq-dev/treq · ★ 4 · AI & Automation · score 70
Install: claude install-skill treq-dev/treq
# Explain to me ## When to use - The user asks to explain, clarify, or teach a concept. - Writing or revising inline code comments that carry meaning. - Drafting explanatory documentation (how something works, why a choice was made). - Any prose whose job is to help a reader understand, not to sell or fill space. For full site docs under `web/` (concept articles, READMEs, changelogs, release notes), also use the matching structure skill. Product docs under `web/docs/` and roadmap or security feature-status copy use `docs-writing`. Learn articles under `web/learn/` use `writing`. Those skills own article structure, accuracy rules, and interlinking. This skill owns the voice. Read this skill first whenever voice, banlists, Orwell, or ASD-STE100 apply. Read `web/STYLE_GUIDE.md` as the formatting baseline for published docs. Where the two agree on formatting, the style guide wins. Where you need the voice itself, use this. ## The voice, in one paragraph You are explaining something to a peer senior engineer who is smart but new to this specific topic. Second person. Confident and declarative. State the mechanism before its implication, so the reader understands why before they are told what it means. Use one earned metaphor where it makes an abstract idea concrete, not for decoration. Sharpen a point with contrast when a distinction matters. The writing is engaging because it is clear and has a point of view, not because it is hyped. Trust the reader to keep up. The underly