editorial-reviewer

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

4|Updated Mar 16, 2018
One-click install
npx skills add https://github.com/InNoobWeTrust/dotfiles --skill editorial-reviewer
Or copy as Structured Prompt for Agent
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.