plot-structure

Plan and manage story arcs, plot points, foreshadowing, and narrative timelines in markdown files.

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/miyake-san/sogo-agent-platform --skill plot-structure-miyake-san
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plot-structure
Source: https://github.com/miyake-san/sogo-agent-platform/tree/main/skills/experimental/plot-structure
Command: npx skills add https://github.com/miyake-san/sogo-agent-platform --skill plot-structure-miyake-san

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writers lose track of plot threads, foreshadowing setups, and event chronology as a story grows. This Skill organizes narrative structure into markdown files so arcs, plot points, timelines, and setup/payoff promises stay consistent across the whole project. ## Core Features & Use Cases - Arc Management: Create main, subplot, character, and thematic arcs using a structured template with setup, rising action, climax, and resolution sections. - Timeline & Foreshadowing Tracking: Maintain a chronological master timeline and per-arc foreshadowing tables tracking planted hints through their payoffs. - Structure Models: Choose from five story structures (three-act, hero's journey, save the cat, kishotenketsu, five-act) with ready-made beat sheets. - Use Case: While drafting a fantasy novel, ask the assistant to add a new subplot arc, log its plot points against chapters, and flag any planted foreshadowing that still lacks a payoff. ## Quick Start Ask the assistant to create a new subplot arc for your story project and add its first plot points to the timeline.

Frequently Asked Questions about plot-structure

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

FAQPage Schema
How do I create a story arc for my novel?

Read story.md for themes, then define the arc name, type (main, subplot, character, or thematic), involved characters, and themes served. The arc is built through conversation covering setup, escalations, climax, and resolution, then saved to plot/arcs/ using the arc template.

What story structure should I use for my genre?

Three-act structure is the default for most stories. Hero's journey fits fantasy and adventure, save the cat suits tightly paced commercial fiction, kishotenketsu works for conflict-light literary fiction, and five-act fits epic or complex drama.

How do I track foreshadowing across chapters?

Each arc file contains a foreshadowing table recording what was planted, the intended payoff, and the chapters for each, with status values of planned, planted, or paid-off. Cross-arc setups can also be tracked in continuity/promises/ files.

Does this skill work without an existing story project?

No, a story project must already exist, verified by the presence of story.md in the project root. Projects are created via the separate story-init skill before plot structure work begins.

What are the limitations of markdown-based plot tracking?

Consistency depends on manually keeping the timeline, arc tables, and index files synchronized. Without the optional Story CLI, registry and backlink checks must be performed manually, which increases the chance of stale cross-references.