Clarity & Accessibility Analysis
The Clarity & Accessibility module evaluates how clearly and accessibly your writing communicates to readers, identifying potential barriers to understanding and suggesting improvements for broader audience engagement.
Overview
This module analyzes your manuscript for clarity of expression, accessibility features, and potential barriers that might prevent readers from fully engaging with your content. It examines sentence structure, vocabulary complexity, cultural references, and overall readability.
Key Features
Clarity Assessment
- Sentence Structure Analysis: Evaluates sentence complexity and clarity
- Vocabulary Complexity: Assesses word choice and technical language usage
- Logical Flow: Examines how ideas connect and progress
- Ambiguity Detection: Identifies potentially confusing passages
Accessibility Evaluation
- Reading Level Assessment: Determines appropriate reading level
- Cultural Sensitivity: Identifies potentially exclusive cultural references
- Inclusive Language: Evaluates language for inclusivity and accessibility
- Barrier Identification: Spots potential obstacles to understanding
Improvement Recommendations
- Clarity Enhancements: Specific suggestions to improve clarity
- Accessibility Improvements: Recommendations for broader accessibility
- Alternative Phrasings: Clearer ways to express complex ideas
- Structural Adjustments: Organizational improvements for better flow
Analysis Components
Per-Chapter Analysis
Each chapter receives detailed analysis including:
- Clarity Score: Overall clarity rating (1-10)
- Accessibility Rating: How accessible the content is to diverse audiences
- Complex Passages: Identification of difficult-to-understand sections
- Improvement Suggestions: Specific recommendations for enhancement
- Reading Level: Estimated reading level and complexity metrics
Manuscript-Wide Analysis
The complete manuscript analysis provides:
- Overall Clarity Trends: Patterns across chapters
- Consistency Assessment: Maintaining clarity standards throughout
- Accessibility Overview: Broad accessibility evaluation
- Priority Improvements: Most important areas to address
Scoring System
- 9-10: Exceptionally clear and accessible
- 7-8: Very clear with minor accessibility considerations
- 5-6: Generally clear but with some barriers
- 3-4: Unclear in places, accessibility concerns
- 1-2: Significant clarity and accessibility issues
Best Practices
Writing for Clarity
- Use active voice when possible
- Vary sentence length while maintaining clarity
- Define technical terms and concepts
- Provide context for cultural references
Accessibility Considerations
- Consider diverse reading levels and backgrounds
- Use inclusive language and examples
- Provide alternative descriptions for complex concepts
- Ensure logical progression of ideas
Common Issues to Address
- Overly complex sentence structures
- Undefined jargon or technical terms
- Cultural assumptions that exclude readers
- Unclear pronoun references
- Inconsistent terminology
Output Format
This module outputs structured JSON in the Codex V1.2 analysis format.
Module Metadata
| Field | Value |
|---|---|
| Module ID | clarity_accessibility |
| Category | Writing Craft |
| Icon | ph ph-eye |
| Content Types | novel, short_story, screenplay, theatrical_play, immersive_experience |
Example Output
{
"body": "## Clarity & Accessibility Analysis\n\n[Comprehensive overview of the text's readability and accessibility, including overall assessment of how easily readers can engage with and understand the content]\n\n### Key Observations\n[2-3 key insights about the text's clarity strengths and challenges]",
"summary": "[One-line summary of the text's overall clarity and accessibility level]",
"children": [
{
"name": "Readability Assessment",
"summary": "Overall ease of reading and comprehension",
"content": "## Readability Assessment\n\n[Analysis of general readability including sentence length variation, paragraph structure, and reading flow. How easily can a reader move through the text without getting lost or fatigued?]",
"attributes": [
{"key": "readability_score", "name": "Readability Score", "value": 7, "dataType": "int"},
{"key": "reading_level", "name": "Reading Level", "value": "general/intermediate/advanced/literary", "dataType": "string"}
]
},
{
"name": "Sentence Clarity",
"summary": "Construction and clarity of individual sentences",
"content": "## Sentence Clarity\n\n[Evaluation of sentence-level clarity. Are sentences well-structured? Are there confusing constructions, dangling modifiers, or ambiguous pronouns? Do complex sentences maintain clarity? Examples of particularly clear or unclear sentences]",
"attributes": [
{"key": "sentence_clarity_score", "name": "Sentence Clarity", "value": 7, "dataType": "int"},
{"key": "clarity_issues", "name": "Clarity Issues Found", "value": 3, "dataType": "int"}
]
},
{
"name": "Vocabulary & Language",
"summary": "Word choice accessibility and appropriateness",
"content": "## Vocabulary & Language\n\n[Assessment of vocabulary level and accessibility. Are words appropriate for the intended audience? Is jargon explained? Are there unnecessarily obscure words? Is the language inclusive and accessible?]",
"attributes": [
{"key": "vocabulary_accessibility", "name": "Vocabulary Accessibility", "value": 8, "dataType": "int"},
{"key": "jargon_level", "name": "Jargon Level", "value": "none/minimal/moderate/heavy", "dataType": "string"}
]
},
{
"name": "Conceptual Clarity",
"summary": "How clearly ideas and events are conveyed",
"content": "## Conceptual Clarity\n\n[Analysis of how clearly the text conveys its ideas, events, and character relationships. Can readers easily follow what's happening? Are motivations clear? Are transitions between scenes or ideas smooth? Are there confusing jumps or unexplained elements?]",
"attributes": [
{"key": "concept_clarity_score", "name": "Conceptual Clarity", "value": 7, "dataType": "int"},
{"key": "confusion_points", "name": "Confusion Points", "value": 2, "dataType": "int"}
]
},
{
"name": "Comprehension Barriers",
"summary": "Obstacles that may impede reader understanding",
"content": "## Comprehension Barriers\n\n[Identification of specific barriers to comprehension. This may include: overly complex prose, unclear references, assumed knowledge, inconsistent terminology, poor information sequencing, or other accessibility issues. List specific examples and suggest improvements]",
"attributes": [
{"key": "barrier_count", "name": "Barriers Identified", "value": 3, "dataType": "int"},
{"key": "barrier_severity", "name": "Barrier Severity", "value": "minor/moderate/significant", "dataType": "string"}
]
}
],
"tags": ["clarity", "accessibility", "readability", "comprehension", "writing-craft"],
"attributes": [
{"key": "overall_rating", "name": "Overall Rating", "value": 7, "dataType": "int"},
{"key": "accessibility_level", "name": "Accessibility Level", "value": "highly accessible/accessible/challenging/difficult", "dataType": "string"}
]
}
Children (per Assessment Area)
| Attribute | Type | Description |
|---|---|---|
| readability_score | int | Overall readability rating (1-10) |
| reading_level | string | Estimated reading level (general, intermediate, advanced, literary) |
| sentence_clarity_score | int | Sentence-level clarity rating (1-10) |
| clarity_issues | int | Number of clarity issues identified |
| vocabulary_accessibility | int | Vocabulary accessibility rating (1-10) |
| jargon_level | string | Level of jargon present (none, minimal, moderate, heavy) |
| concept_clarity_score | int | Conceptual clarity rating (1-10) |
| confusion_points | int | Number of confusing points identified |
| barrier_count | int | Number of comprehension barriers found |
| barrier_severity | string | Severity of barriers (minor, moderate, significant) |
Top-Level Attributes
| Attribute | Type | Description |
|---|---|---|
| overall_rating | int | Overall clarity and accessibility score (1-10) |
| accessibility_level | string | Overall accessibility assessment (highly accessible, accessible, challenging, difficult) |
Modules are prompt-based analysis templates — you can create your own.
Integration with Other Modules
This module works effectively with: - Language & Style: For comprehensive writing analysis - Cultural Authenticity: For cultural sensitivity assessment - Thematic Depth: To ensure themes are clearly communicated - Reader Emotions: To verify emotional clarity and impact
The Clarity & Accessibility module helps ensure your writing reaches and resonates with the widest possible audience while maintaining your unique voice and style.