skills.rest
unbakedcosmos
unbakedcosmosCOMMUNITY
Explore all skills by this author →
GitHub

bmad-editorial-review-structure

Reviews document structure and proposes cuts, merges, and reorganization recommendations.

Updated Jul 9, 2026
Search Tags:#documentation#writing#markdown#information architecture#content optimization#editorial review#structural editing
One-click install
npx skills add https://github.com/unbakedcosmos/thumbnailer --skill bmad-editorial-review-structure-unbakedcosmos
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-editorial-review-structure
Source: https://github.com/unbakedcosmos/thumbnailer/tree/main/.claude/skills/bmad-editorial-review-structure
Command: npx skills add https://github.com/unbakedcosmos/thumbnailer --skill bmad-editorial-review-structure-unbakedcosmos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Documents often accumulate redundant sections, buried critical information, and poor flow that frustrate readers. This Skill performs a structural editorial review that identifies what to cut, merge, move, or condense before any copy editing happens. ## Core Features & Use Cases - Structural Analysis: Maps each section against purpose-fit structure models (tutorial, reference, conceptual, prompt, strategic) and flags redundancy, scope violations, and buried information. - Reader-Type Calibration: Applies different principles for human readers (preserve comprehension aids) versus LLM readers (optimize for precision and density). - Prioritized Recommendations: Outputs categorized actions (CUT, MERGE, MOVE, CONDENSE, QUESTION, PRESERVE) with rationale and estimated word-count impact. - Use Case: A technical writer has a 3,000-word setup guide that feels bloated. Run this review to get a prioritized list of structural changes, such as merging duplicate prerequisites sections and moving the FAQ inline, with an estimated 25% length reduction. ## Quick Start Ask the AI to perform a structural editorial review of your document, optionally specifying the purpose, target audience, reader type, and length target.

Frequently Asked Questions about bmad-editorial-review-structure

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

FAQPage Schema
How do I review document structure before copy editing?▼

Run a structural editorial review that maps each section against the document's purpose and flags sections to cut, merge, move, or condense. This Skill outputs prioritized recommendations with rationale and estimated word savings before any line-level editing begins.

What is the difference between structural editing and copy editing?▼

Structural editing addresses organization, flow, redundancy, and section-level decisions, while copy editing fixes grammar, style, and word choice. Structural review should run first because rewriting sentences in sections that will later be cut wastes effort.

Can I customize the review with my own style guide?▼

Yes, pass a style_guide input and it overrides all generic principles in the review, including reader-type priorities and structure model selection. The only exception is that content ideas themselves are never changed, only their organization.

How does the review differ for LLM readers versus humans?▼

For LLM readers the review optimizes for precision, consistent terminology, and explicit definitions while cutting warmth and orientation sections. For human readers it preserves comprehension aids like examples, summaries, diagrams, and encouraging tone.

Does the structural review rewrite my document automatically?▼

No, it only proposes recommendations and never executes changes. You receive a categorized list of CUT, MERGE, MOVE, CONDENSE, QUESTION, and PRESERVE actions and decide which to accept.

Related Skills

Explore More Content & Communication Skills→
Rinzler78Rinzler78
1

bmad-editorial-review-structure

Review document structure and recommend prioritized cuts, merges, moves, and condensation.

Community
Advanced
cris-mcris-m

editing

Proofread, polish, and refine prose through structural, line, and copy edits.

Community
Intermediate
PracticalSwanPracticalSwan
7

documentation-verification

Validate documentation completeness, broken links, and code example accuracy.

Community
Intermediate
ShubhamsabooShubhamsaboo
131.7k

editor

Edit text for clarity, grammar, and readability across documents.

Community
Basic