Purpose
This skill provides a complete AI proofing workflow for narrative Markdown files of any length and genre. It operates without requiring pre-existing metadata or manual annotations, automatically extracting narrative context and applying a systematic 16-task protocol to improve human authenticity while preserving voice.
When to Use This Skill
Invoke this skill when you need to:
- Analyze narrative text for AI-generated signals and patterns
- Remove repetitive vocabulary, formulaic phrasing, or mechanical construction
- Enhance character voice consistency and differentiation
- Improve emotional depth and sensory grounding
- Increase syntactic variety and natural burstiness
- Verify narrative coherence before publication
- Humanize text that may have been assisted by AI
How to Use
Basic Invocation
/aiproofing-text "Analyze and revise this manuscript" path/to/manuscript.md
Or provide text inline:
/aiproofing-text "AI proof this text" "Your narrative text here"
Workflow Phases
The skill executes a structured 6-phase protocol:
- Intake and Baseline – Extracts narrative structure, POV, tone, characters, and establishes baseline metrics
- Lexical Depth – Analyzes vocabulary diversity, idioms, and overused patterns
- Syntax and Grammar Flexibility – Evaluates sentence structure, part-of-speech balance, and modal variety
- Readability and Flow – Checks complexity calibration, formulaic patterns, and rhythmic burstiness
- Voice and Emotion – Assesses character voice consistency, emotional intensity, and figurative language
- Quality Assurance – Validates consistency, continuity, and publication readiness
Understanding the Output
The skill generates:
- Revised manuscript with improvements across all categories
- Analysis report summarizing findings for each protocol area
- Specific recommendations for any remaining concerns
- Publication readiness verdict (Ready / Ready with tweaks / Hold)
Protocols Included
This skill includes 20 specialized analysis protocols:
- AIproof_plan.md – Master workflow organizing all 16 tasks
- manuscript_analysis.md – Automated intake and context extraction
- automation_playbook.md – Detailed agent execution guide
- AIproofcheck.md – Quick verification checklist
- ai_tell_checklist.md – Fast scan for common AI signals
Category Guides:
- vocabulary_analysis.md – Lexical variety and clustering
- idiomatic_analysis.md – Phrase authenticity
- overused_vocabulary_analysis.md – Bureaucratic/tech drift removal
- sentence_structure_analysis.md – SVO pattern breaking
- part_of_speech_analysis.md – Noun/verb/adjective balance
- modal_epistemic_analysis.md – Uncertainty and perspective nuance
- readability_analysis.md – Density and comprehension calibration
- formulaic_pattern_analysis.md – Template disruption
- burstiness_analysis.md – Controlled stylistic surprise
- character_voice_analysis.md – Voice differentiation and consistency
- emotional_intensity_analysis.md – Sensory and emotional grounding
- metaphor_analysis.md – Figurative language and cliché replacement
- consistency_check.md – Continuity and tone cohesion
- final_analysis.md – Publication-readiness validation
Key Features
- Neutral and Genre-Agnostic – Works with any narrative length, genre, tense, or POV
- No Metadata Required – Auto-derives context from the source text alone
- Systematic and Thorough – 16 sequential tasks covering linguistic, structural, and stylistic dimensions
- Voice-Preserving – Enhances authenticity without flattening character or narrative style
- Agent-Ready – Designed for autonomous execution with clear inputs and outputs
- Iterative-Friendly – Allows refinement and rollback between phases
Example Workflow
Input: An unpublished 5,000-word short story with some AI-assisted passages
Processing:
- Extract 4 characters, 3 locations, present tense, third-person limited POV
- Scan vocabulary against overuse clusters; flag 12 repetition hotspots
- Analyze sentence rhythms; identify 3 formulaic openings and 5 SVO patterns
- Review emotional intensity; add sensory grounding to 4 climactic moments
- Check voice consistency across 4 POV sections; differentiate narrator tone
- Verify all changes integrate; confirm readability metrics match intent
Output: Revised manuscript + detailed report addressing each of 16 task categories
Tips for Best Results
- Provide the full narrative context (chapters, scenes, backstory references) for most accurate analysis
- Allow the skill to complete all 6 phases before drawing conclusions
- Review and selectively accept recommendations; preserve intentional stylistic choices
- Use the "Ready with tweaks" verdict to identify areas for human refinement
- Keep pre-edit snapshots for comparison and rollback
Technical Details
The skill includes a Python orchestration script (scripts/aiproof_runner.py) that helps sequence tasks and manage outputs if running via automation.
Protocol files reference each other; the skill maintains cross-references so you can jump to relevant analyses.
Version: 1.0 Status: Production Ready Last Updated: 2025-12-20
Scan to join WeChat group