Writing is often a deeply intuitive and subjective process. However, great editing and revision can be significantly enhanced by objective data and insightful analysis. The “Report” feature in Manuscripts.ai is designed to provide you with this crucial perspective, acting as your personal editor and literary analyst.
This feature generates a comprehensive, data-driven analysis of your manuscript or paper, moving beyond simple grammar checks to offer deep insights into everything from readability and pacing to thematic consistency and character development. It helps you see your work from a new vantage point, identify hidden issues, and make more informed decisions during the revision process.
Part 1: Summary Report (The Quantitative Analysis)
This section provides a statistical and data-driven overview of your manuscript. It’s the “what” of your writing—a clear, objective breakdown of its core components.
Core Statistics
This is your at-a-glance dashboard, providing key metrics:
- Total Word Count: The overall length of your manuscript.
- Chapter/Section Breakdown: A list of all chapters or sections with their individual word counts, helping you identify parts that may be too long or too short.
- Estimated Reading Time: An algorithmically calculated estimate of how long it would take an average reader to finish your book.
- Vocabulary Analysis: Includes metrics like unique word count and lexical density, giving you a sense of the richness and complexity of your vocabulary.
Readability Analysis
How accessible is your prose? This section uses standard linguistic models to score the readability of your text.
- Flesch-Kincaid Grade Level: This score estimates the U.S. school grade level required to understand your text. A score of 8.0, for instance, means your writing is accessible to an average 8th grader. This is vital for ensuring your writing matches your target audience (e.g., a Young Adult novel should have a different score than a doctoral thesis).
- Flesch Reading Ease: A score from 0-100, where higher scores indicate easier readability. Conversational writing for the web usually scores between 60-70.
- The report provides an overall score and also breaks it down by chapter, allowing you to pinpoint sections that may be overly convoluted or dense.
Pacing and Dialogue Analysis
This section helps you understand the rhythm and flow of your story.
- Pacing Chart: A visual graph that shows the distribution of different types of writing throughout your manuscript. It color-codes sections based on whether they are primarily Action, Description, or Dialogue. This allows you to see if your story has long stretches of description that might slow the pace, or if your rising action is appropriately balanced.
- Dialogue to Narration Ratio: This metric shows the percentage of your text that is dialogue versus narrative. Different genres have different conventions, and this helps you see if you are aligned with your genre’s expectations. It also flags chapters that are exceptionally dialogue-heavy or dialogue-light.
Character and Entity Analysis
This part of the report tracks the “nouns” of your story, ensuring they are handled consistently.
- Character Mentions: A list of all characters from your Lore Book, ranked by the number of times they are mentioned. This can be surprisingly revealing, sometimes showing that a character you considered minor actually dominates the narrative, or a character crucial to the plot is barely mentioned.
- Sentiment Arc per Character: For major characters, the AI plots their emotional journey throughout the story. It analyzes the text surrounding the character to determine if it’s positive, negative, or neutral, creating a graph that shows their emotional highs and lows from beginning to end. This helps you visualize whether your character’s arc is satisfying and dynamic.
Part 2: Overview and Improvements (Your Interactive Revision Sidebar)
If the Summary Report provides the high-level data, the Overview and Improvements feature is your interactive, AI-powered editor that lives in your right sidebar. This is where the AI provides qualitative, actionable feedback to guide your revision process.
As you write, or after generating a full report, this sidebar populates with a dynamic checklist of suggestions, categorized to help you focus on specific areas of improvement.
How to Use the Improvements Sidebar
The sidebar provides a real-time analysis of your prose, flagging potential issues and offering concrete suggestions. The workflow is designed to be seamless:
- View Categories: The sidebar organizes feedback into clear categories like “Repetitive Language” or “Clarity & Readability.”
- Expand a Suggestion: Click on a category to see specific instances the AI has flagged. For example, under “Show, Don’t Tell,” it might identify the sentence, “Sarah was terrified.”
- Jump to Text: Each suggestion is linked directly to the corresponding passage in your manuscript. Clicking it instantly navigates your editor to that exact sentence.
- Revise and Resolve: Apply the suggestion or make your own edits. As you resolve issues, you can mark them as complete, turning revision into a manageable and satisfying process.
Key Improvement Categories
- Prose and Style Suggestions:
- Repetitive Word and Phrase Finder: The sidebar lists words and “crutch phrases” you may be overusing (e.g., “suddenly,” “just”) and shows the count for each, allowing you to jump to every instance.
- Passive Voice Usage: It highlights sentences written in the passive voice, often offering an active-voice alternative.
- ‘Show, Don’t Tell’: Identifies sentences where you’ve told the reader an emotion and suggests ways to show it through action or description.
- High-Level Thematic & Structural Feedback:
- Plot Consistency Check: The AI cross-references events with your Lore Book and flags inconsistencies as a high-priority item in the sidebar. For example: “Flagged Inconsistency: In Chapter 5, the protagonist says they cannot use fire magic, but in Chapter 18, they cast a fire spell without explanation.”
- Character Arc Analysis: The AI provides a summary of each main character’s development, flagging moments that may feel underdeveloped or inconsistent with their established motivations.
- Theme Coherence: The AI tracks your main themes and will point out sections where a theme is less present, suggesting opportunities to strengthen it.
The Overview and Improvements sidebar transforms revision from a daunting task into an interactive checklist. It closes the loop, turning your creative output into a clear set of steps for transforming a good draft into a truly great piece of writing.