Agent Skills: 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 preserving every number exactly. Use when a draft assumes knowledge the reader lacks, reads as insider or "clever", name-drops terms before defining them, leans on unexplained metaphor, or sounds AI-written; or when the user mentions first-time reader, plain language, define before use, sounds like AI, em dash, too clever, or jargon. Complements ladder-of-abstraction, slop-detector and narrative-fidelity-audit.
Install this agent skill to your local
Skill Files
The files that make up reader-first-prose.
More agent skills
- adr-architectureDocuments 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.
- write-script-bunnativeMUST use when writing Bun Native scripts. The script must start with //native to run on the native worker.
- proveFormal theorem proving with research, testing, and verification phases
- jupyterRead, modify, execute, and convert Jupyter notebooks programmatically. Use when working with .ipynb files for data science workflows, including editing cells, clearing outputs, or converting to other formats.
- refineEnd-of-session reflection. Reviews friction encountered during the session and proposes updates to docs/ to capture lessons learned.
- codebase-onboarding不慣れなコードベースを分析し、アーキテクチャマップ、主要なエントリポイント、規約、スターターCLAUDE.mdを含む構造化オンボーディングガイドを生成します。新しいプロジェクトに参加するか、リポでClaude Codeを初めてセットアップする場合に使用します。