editorial-reviewer

Polish stakeholder-facing documents by rewriting prose and reorganizing structure.

4|Updated Mar 16, 2018

Search Tags:#readability #prose #structure #editorial #document-review

Ready to run

npx skills add https://github.com/InNoobWeTrust/dotfiles --skill editorial-reviewer

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: editorial-reviewer
Source: https://github.com/InNoobWeTrust/dotfiles/tree/main/.agents/skills/editorial-reviewer
Command: npx skills add https://github.com/InNoobWeTrust/dotfiles --skill editorial-reviewer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Editorial-reviewer provides a two-mode framework to polish stakeholder-facing documents by improving clarity (Prose mode) and document structure (Structure mode). It helps rewrite ambiguous sentences, reorganize content, and prepare materials for stakeholders without altering factual content.

Core Features & Use Cases

Prose: fix clarity, remove ambiguity, preserve author voice.
Structure: reorganize sections, tighten document flow, reduce redundancy.
Use Case: polish a PRD or spec before sharing with executives to ensure readability and coherence.

Quick Start

Run a two-mode editorial pass: first structure, then prose polish to enhance clarity.

Frequently Asked Questions about editorial-reviewer

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

FAQPage Schema

How do I improve readability and polish prose for stakeholder-facing documents?▼

To improve readability and polish prose for stakeholder-facing documents, use a two-mode editorial pass that reorganizes structure and refines sentence-level clarity. This removes ambiguity and tightens flow without altering factual content.

What is the best way to reorganize PRD or spec structure before sharing with executives?▼

The best way to reorganize PRD or spec structure is to run a document-level editorial pass that tightens flow and reduces redundancy. This structure mode reorders sections to prepare materials for executives, ensuring coherence and stakeholder understanding.

Can I fix ambiguous sentences in a document without changing the original author intent?▼

You can fix ambiguous sentences without changing author intent by applying a prose-level editorial polish. This mode rewrites sentences to improve clarity and preserve author voice while preparing stakeholder-facing materials.

When do I need to run an editorial review on my document?▼

You need an editorial review when clarity or organization is in question, especially before sharing PRDs, specs, or other stakeholder-facing documents. Running both structure and prose passes ensures readability and coherence for your audience.

Does editorial polishing alter the factual content of my technical specs?▼

Editorial polishing does not alter the factual content of technical specs. The process preserves author intent while improving readability, fixing sentence-level clarity, and reorganizing document structure for stakeholders.

What are the limitations of using automated prose polishing for stakeholder communication?▼

Automated prose polishing focuses on sentence-level clarity and document structure, meaning it will not generate new technical content or verify factual accuracy. It strictly reorganizes sections and rewrites ambiguous sentences while preserving existing intent.