story-init

Initialize a fiction project with structured markdown folders, registries, and YAML frontmatter.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a new fiction project often means inventing an ad-hoc folder layout that later breaks continuity tracking. This Skill scaffolds a complete, cross-referenced markdown structure for a story so characters, worldbuilding, plot, scenes, and continuity stay organized from day one. ## Core Features & Use Cases - Structured Project Scaffolding: Creates a story bible (story.md), character/worldbuilding/plot registries, scene tracking, continuity state, glossary, and chapter tracker, all with YAML frontmatter. - CLI-Aware Workflow: Prefers the Story CLI (story init) or the bundled story-maintenance/scripts/story.js fallback, with manual file creation as a last resort. - Continuity-Ready Conventions: Enforces kebab-case filenames, schema-version 2 frontmatter, bidirectional cross-links, and _index.md registries used by all other story skills. - Use Case: You want to start a new science-fiction novel. Provide the title, genre, synopsis, themes, POV, and tense, and receive a fully populated project folder ready for character creation, worldbuilding, and plotting. ## Quick Start Ask the assistant to start a new story project with your title, genre, synopsis, setting era, themes, POV, and tense.

Frequently Asked Questions about story-init

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

FAQPage Schema
How do I start a new fiction writing project with structured files?

Provide the title, genre, sub-genre, synopsis, setting era, themes, POV style, and tense. The skill creates a kebab-case project folder containing story.md, character and worldbuilding registries, plot structure, scene tracking, continuity state, glossary, and a chapter tracker.

What files does a story project scaffold include?

The scaffold includes story.md as the story bible, _index.md registries for characters, worldbuilding, plot, scenes, glossary, and chapters, plus continuity/state.md, continuity/questions, continuity/promises, and plot/timeline.md, all with YAML frontmatter.

Can I initialize a story project without the Story CLI installed?

Yes. If the story command is unavailable, the skill falls back to the bundled story-maintenance/scripts/story.js script via node. If neither exists, it creates the folder structure and files manually following the documented templates.

When should I not use story initialization?

Do not use it to add content to an existing story project. For ongoing work, use the domain-specific skills such as character-management, worldbuilding, or plot-structure, which operate on the established registries.

Why does story initialization enforce kebab-case filenames and frontmatter?

Kebab-case filenames and YAML frontmatter provide consistent entity identifiers and machine-readable metadata across all story skills. This enables bidirectional cross-linking, registry lookups, and deterministic CLI validation with story validate.