plainly

Rewrites unclear answers as plain-language causal chains checked against six named defects.

Updated Nov 17, 2025
One-click install
npx skills add https://github.com/vzakharov/vovazakharov.com --skill plainly-vzakharov
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plainly
Source: https://github.com/vzakharov/vovazakharov.com/tree/main/.claude/skills/plainly
Command: npx skills add https://github.com/vzakharov/vovazakharov.com --skill plainly-vzakharov

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Technical answers often fail to land: they quote error strings instead of causes, bury the conclusion under caveats, or acknowledge a remark instead of answering it. This Skill re-explains a failed answer — or answers a fresh question — as a plain-language causal chain, cause first, in the reader's own nouns. ## Core Features & Use Cases - Two invocation modes: Run bare against an answer that did not land to re-explain it, or invoke with a question to answer it under the plain-language rule, investigation included. - Three-step pass: Identify the cause, reason, or constraint the answer rests on (reading history, input, or configuration first); draft conclusion-first in the reader's nouns; then re-check the draft before writing it out. - Six named defects as a checklist: Symptom-as-finding, buried lede, untranslated nouns, broken chain, fog, and receipt — each with an observable tell, so a bad report can be called out in one word. - Use Case: A user replies "just tell me why it broke" after a jargon-heavy diagnosis. Invoke this Skill to rewrite the diagnosis as a causal chain: what failed, why each step followed, and what would settle any remaining uncertainty. ## Quick Start Re-explain your last answer in plain language, cause first, using the plainly skill.

Frequently Asked Questions about plainly

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I re-explain a technical answer in plain language?

Invoke the Skill bare after an answer that did not land. It rebuilds the answer as a causal chain: conclusion first in the reader's own words, then each step with why it followed, then caveats only if they change what the reader should do.

What are the six writing defects this Skill checks?

The six defects are symptom-as-finding, buried lede, untranslated nouns, broken chain, fog, and receipt. Each has an observable tell in the draft text, so a bad report can be called out with a single word.

When should I invoke this Skill with a question instead of bare?

Invoke it with a question when you want the answer itself written under the plain-language rule from the start. The Skill then investigates the cause first — reading history, input, or configuration — before drafting the answer.

What is the receipt defect in written replies?

Receipt is replying about what someone said instead of answering it — acknowledging a joke rather than returning it, or filing an aside instead of engaging it. Its tell is a register shift, such as a neighboring sentence going formal or referring to the remark in the third person.

Does this Skill replace a team's writing style guide?

No. It operates independently of the house voice file, which defines how the team is addressed in every session. A house voice can be deliberately less plain while still using this Skill when a plainer explanation is requested.