skills.rest
peshay
peshayCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

bmad-editorial-review-structure

Analyze markdown and plain text structure for clarity and flow.

1|Updated Apr 27, 2026
Search Tags:#writing guidance#document review#structure analysis#content clarity#editorial assistance
One-click install
npx skills add https://github.com/peshay/portfolixir --skill bmad-editorial-review-structure-peshay
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-editorial-review-structure
Source: https://github.com/peshay/portfolixir/tree/main/.claude/skills/bmad-editorial-review-structure
Command: npx skills add https://github.com/peshay/portfolixir --skill bmad-editorial-review-structure-peshay

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires content_analysis, markdown_processing, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

The skill resolves the complexity and ambiguity in document structures, enhancing comprehension and workflow efficiency through meticulous analysis.

Core Features & Use Cases

  • Structural Optimization: Proposes improvements in document structure, organization, and clarity.
  • Readability Enhancement: Implements changes to boost comprehension and user experience.
  • Use Case: Optimize a novel report for clarity, flow, and accessibility before final review, reducing cognitive load and speeding up reader comprehension.

Quick Start

Perform an editorial review on your document using the bmad-editorial-review-structure skill and style_guide, setting a reader_type to "humans" or "llm".

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 analyze markdown document structure for clarity and flow?▼

To analyze markdown document structure for clarity, the Skill performs structural analysis on markdown and plain text, proposing cuts, reorganization, and simplification to enhance comprehension and workflow efficiency.

What is the best way to improve readability and reduce cognitive load in complex documents?▼

Improving readability in complex documents is achieved through structural optimization that proposes reorganization and simplification, reducing cognitive load and speeding up reader comprehension before final review.

Can I use editorial review to optimize plain text content for both human and LLM readers?▼

Yes, editorial review can optimize plain text content by setting a reader type to either humans or llm, ensuring the structural analysis and proposed cuts maintain comprehension for the intended audience.

Does document structure analysis work with markdown processing for complex reports?▼

Document structure analysis works with markdown processing by validating input and using structured formats to analyze complex reports, proposing organization improvements that boost readability and user experience.

What are the limitations of using automated structural analysis for editorial reviews?▼

Automated structural analysis for editorial reviews focuses on proposing cuts, reorganization, and simplification while maintaining comprehension, making it appropriate for complex documents but requiring a final manual review for nuanced style adjustments.

Related Skills

Explore More Content & Communication Skills→
geekdesign27geekdesign27

bmad-editorial-review-prose

Review text for comprehension issues and output suggested fixes in a three-column table.

Community
Intermediate
wahabmalikwahabmalik

bmad-editorial-review-structure

Review technical documents and recommend cuts, reorganization, and simplification.

Community
Advanced
0xHoneyJar0xHoneyJar
2

validating

Validate UI sprint components' physics and rigor compliance via Markdown reports.

Official
Intermediate
maltemdmaltemd

improving-readability-and-flow

Restructure and rewrite drafts to improve readability and flow.

Community
Intermediate