structural-audit

Community

Audit story structure and prioritize fixes.

Authorbilllzzz26
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Provides a comprehensive, gate-enforced evaluation of narrative structure to detect missing plot beats, weak character arcs, unresolved conflicts, and pacing problems so authors and story engineers can fix issues before exporting or publishing.

Core Features & Use Cases

  • Pre-export Validation Gate: Runs a mandatory validate_story_structure pass, surfaces errors and warnings grouped by severity, and blocks or permits exports only after explicit user acknowledgment for blocking issues.
  • Four-Phase Audit: Executes Structure → Characters → Conflicts → Pacing analyses with explicit checks for inciting incidents, midpoint, climax, character arc completeness, conflict escalation, and event density.
  • Scored Health Report & Prioritized Actions: Produces a numeric health score, per-section statuses, per-item findings, and a prioritized remediation list to guide fixes.
  • Use Cases: Run when a user asks to "audit", "check structure", or requests review of a StoryGraph export; integrate as a validation step before exporting mermaid, canvas, dashboard, or markdown outputs.

Quick Start

Audit my story "The Dragon's Heir" and generate a full structural health report with prioritized actions and export gating.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: structural-audit
Download link: https://github.com/billlzzz26/visual-story-extension/archive/main.zip#structural-audit

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.