skills.rest
billlzzz26
billlzzz26COMMUNITY
Explore all skills by this author →
GitHub

structural-audit

Analyze StoryGraph JSON to detect structural imbalances and generate health reports.

4|1|Updated Feb 19, 2026
Search Tags:#pacing#validation#analyze#story-structure#three-act#character-arcs#storygraph
One-click install
npx skills add https://github.com/billlzzz26/visual-story-extension --skill structural-audit
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: structural-audit
Source: https://github.com/billlzzz26/visual-story-extension/tree/main/skills/structural-audit
Command: npx skills add https://github.com/billlzzz26/visual-story-extension --skill structural-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about structural-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check my story structure for missing plot beats and pacing issues?▼

A structural audit analyzes your story graph to identify missing plot beats, incomplete character arcs, unresolved conflicts, and pacing imbalances, producing a scored health report with prioritized remediation steps to fix issues before publishing.

What does a three-act structure validation check look for?▼

Three-act structure validation checks for narrative balance, verifying the presence of inciting incidents, midpoints, climaxes, character arc completeness, conflict escalation, and event density pacing across the story graph.

How do I validate a StoryGraph JSON export before publishing?▼

You validate a StoryGraph JSON export by running a pre-export gating pass that checks for blocking errors and warnings, requiring explicit user acknowledgment of blocking issues before allowing the export.

Can I audit character arcs and conflict escalation in my story graph?▼

Yes, a four-phase audit evaluates Structure, Characters, Conflicts, and Pacing, explicitly checking for character arc completeness, conflict escalation validation, and event density within your story graph.

What is the best way to prioritize story structure fixes?▼

The best way to prioritize story structure fixes is to generate a scored health report that classifies issues by severity and computes a prioritized remediation list, guiding you to address blocking errors before warnings.

Does the audit block exports if my story has unresolved conflicts?▼

Yes, the audit enforces a pre-export validation gate that blocks exports when blocking errors like unresolved conflicts are present, requiring explicit user acknowledgment before the export can proceed.

Related Skills

Explore More Content & Communication Skills→
billlzzz26billlzzz26
4

conflict-detection

Detect and map conflicts in a Visual Story Planner StoryGraph.

Community
Intermediate
delta-and-betadelta-and-beta

analyst-data-export

Export Braze data from dashboard CSVs and Export API responses into analyzable datasets.

Community
Advanced
felipesantiago-coderfelipesantiago-coder

storyboard-manager

Plan story structure and validate narrative consistency in markdown files.

Community
Intermediate
human-avatarhuman-avatar
212

narrative-structure-mapping

Map communication into three-act story structures with evidence placement.

Official
Intermediate