Reader First Prose
Rewrites expository prose for a reader meeting the subject for the first time, not an insider who already shares the writer's knowledge. Enforces introduce-before-use (every entity, term and acronym defined on first mention, in an order a newcomer can follow), grounds or cuts every metaphor in the same breath it appears, converts compressed or nominalized logic into a plain if-then, and kills the two loudest machine tells, the em dash and the terse two-beat antithesis ("X. Not Y."). Carries an honesty pass so the prose never out-claims its evidence, marking inference as inference and preservin
Install
/plugin marketplace add lyndonkl/claudeThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add lyndonkl/claude --skill reader-first-prosegit clone --depth 1 https://github.com/lyndonkl/claude.git /tmp/claude
mkdir -p ~/.claude/skills
cp -r /tmp/claude/skills/reader-first-prose ~/.claude/skills/reader-first-prosePersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Reader-First Prose ## Table of Contents - [The stance](#the-stance) - [Clarity rules — write for a first-time reader](#clarity-rules) - [Honesty rules — own the edges of what you know](#honesty-rules) - [The two tics to kill](#the-two-tics-to-kill) - [Per-sentence pass](#per-sentence-pass) - [Worked examples](#worked-examples) - [Guardrails](#guardrails) **Related skills:** Runs at the sentence layer alongside `prose-force-and-rhythm`. Hands altitude problems to `ladder-of-abstraction` (middle-rung / too-abstract), other AI signatures to `slop-detector`, evidence over-claim to `narrative-fidelity-audit`, and number handling to `numbers-in-narrative`. Score with `readability-check` after. ## The stance One question governs every edit: **who does this sentence think it is talking to?** Two stances produce two drafts of the same fact. - **The insider draft** is written for a reader who already knows the world. It moves fast, gestures, names things it never defined, and lets rhythm carry meaning. It reads as clever. It sounds like it already knows the answer. This is the default a language model reaches for, because it is trained on finished, insider prose. - **The reader-first draft** is written for a sharp person meeting the subject for the first time. Not a less capable reader; just one who was not already in the room. It introduces before it leans, grounds before it flies, and states plainly what the insider draft compresses.
Details
- Skill name
reader-first-prose- Repository
- lyndonkl/claude
- Path
skills/reader-first-prose/SKILL.md- Repo updated
- 1 September 2026
FAQ
What does the Reader First Prose skill do?
Rewrites expository prose for a reader meeting the subject for the first time, not an insider who already shares the writer's knowledge. Enforces introduce-before-use (every entity, term and acronym defined on first mention, in an order a newcomer can follow), grounds or cuts every metaphor in the same breath it appears, converts compressed or nominalized logic into a plain if-then, and kills the two loudest machine tells, the em dash and the terse two-beat antithesis ("X. Not Y."). Carries an honesty pass so the prose never out-claims its evidence, marking inference as inference and preservin
How do I install the Reader First Prose skill?
Claude Code plugin: /plugin marketplace add lyndonkl/claude. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Reader First Prose popular?
It lives in lyndonkl/claude, which has 200 GitHub stars and 25 forks.
Related skills
Abstraction Concrete Examples
200lyndonkl/claude
Builds structured abstraction ladders that translate high-level principles into concrete, actionable examples across 3-5 levels. Bridges communication gaps, reveals hidden assumptions, and tests whether abstract ideas work in practice. Use when explaining concepts at different expertise levels, moving between abstract principles and concrete implementation, identifying edge cases by testing ideas against scenarios, designing layered documentation, decomposing complex problems into actionable steps, or bridging strategy-execution gaps.
Academic Letter Architect
200lyndonkl/claude
Guides the creation of evidence-based academic recommendation letters, reference letters, and award nominations that combine concrete examples, meaningful comparisons, and genuine enthusiasm. Use when writing recommendation letters for students, postdocs, or colleagues, or when user mentions recommendation letter, reference, nomination, letter of support, endorsement, or needs help with strong advocacy and comparative statements.
Adr Architecture
200lyndonkl/claude
Documents significant architectural and technical decisions with full context, alternatives considered, trade-offs analyzed, and consequences understood. Creates a decision trail that helps teams understand why decisions were made. Use when choosing between technology options, making infrastructure decisions, establishing standards, migrating systems, or when user mentions ADR, architecture decision, technical decision record, or decision documentation.
Relative Valuation Toolkit
200lyndonkl/claude
Prices a company against peers and the market with multiples — builds PE, PEG, PBV, EV/EBITDA, EV/EBIT, EV/Sales and EV/Invested Capital with the numerator/denominator consistency rule enforced, computes peer medians and quartiles, fits an ordinary-least-squares regression of a multiple on its companion variables for a sector or the whole market, reports predicted versus actual under and over valuation, and derives the intrinsic multiple from DCF fundamentals. Prices a conglomerate division by division with a sum of the parts, and values cross-holdings and minority interests. Bundles Damodaran
Project Risk Register
200lyndonkl/claude
Identifies, assesses, and prioritizes project risks using probability-times-impact scoring (risk matrix), then assigns owners, mitigation plans, contingencies, and triggers to track risk evolution over the project lifecycle. Use when managing project uncertainty, building a risk register, conducting risk assessments, defining risk mitigation plans, or when user mentions risk register, risk management, probability-impact matrix, or asks "what could go wrong with this project?".
Section Portfolio Assessment
200lyndonkl/claude
Classifies each substacker section as healthy / drifting / candidate-for-prune based on post volume, engagement trend, and niche alignment. Produces table + 2-4 paragraph narrative. Used in every quarterly review. Trigger keywords — portfolio, section health, healthy drifting prune, section assessment, which section is carrying.
Browse the most popular Claude skills, all finance & crypto skills, or write your own with the skills generator.