How danjdewhurst/story-skills works
Story Skills provides a markdown-and-frontmatter story project format, agent writing/planning skills, and a companion CLI that checks and manages story projects. The principal CLI workflow is to inspect a project, run deterministic continuity and craft checks, and report file-addressed findings; documented commands also support repair guidance, project validation, links, and publishing. The graph centers on the sampled CLI/runtime modules. README-documented capabilities whose implementation paths are absent from the tree are represented only where a supported source path exists; unsampled internal wiring is omitted or marked unverified.
Main entry points: story.js Story operations · continuity.js Continuity engine · commands.js Command handling · context.js Draft context
Components 20
CLI entry
- Story CLI
src/cli.js - Command handling
src/commands.js
Project model
- Story operations
src/story.js - Frontmatter parser
src/frontmatter.js - Project files
src/files.js - Draft context
src/context.js
Story analysis
- Chapter chronology
src/chronology.js - Continuity engine
src/continuity.js - State progressions
src/progressions.js - Series canon
src/series.js - Prose analysis
src/prose.js - Voice analysis
src/voices.js
Findings and outputs
- Finding rules
src/findings.js - Finding exemptions
src/exemptions.js - Markdown utilities
src/markdown.js - Publishing
src/publishing.js - Book packaging
src/packaging.js - HTML output
src/html.js - Exit status
src/exit-codes.js
Other components
- Author or agent
Connections 29
- Author or agent → Story CLI: invokes
README.md - Story CLI → Command handling: dispatches
- Command handling → Story operations: manages projects
src/commands.js - Story operations → Frontmatter parser: parses metadata
src/story.js - Story operations → Project files: reads and writes
src/story.js - Story operations → Continuity engine: runs checks
src/story.js - Story operations → Chapter chronology: uses ordering
src/story.js - Story operations → State progressions: sorts state changes
src/story.js - Story operations → Series canon: checks linked books
src/story.js - Story operations → Draft context: builds draft context
src/story.js - Draft context → Chapter chronology: uses ordering
src/context.js - Draft context → Continuity engine: uses identifiers
src/context.js - Draft context → State progressions: resolves state
src/context.js - Continuity engine → Chapter chronology: checks story order
src/continuity.js - Continuity engine → State progressions: checks state changes
src/continuity.js - Continuity engine → Finding rules: creates findings
src/continuity.js - Continuity engine → Finding exemptions: applies exemptions
src/continuity.js - Continuity engine → Markdown utilities: normalizes text
src/continuity.js - Command handling → Prose analysis: runs prose checks
src/commands.js - Command handling → Voice analysis: runs voice checks
src/commands.js - Prose analysis → Voice analysis: uses voice helpers
src/prose.js - Prose analysis → Finding rules: creates warnings
src/prose.js - Voice analysis → Finding rules: creates warnings
src/voices.js - Publishing → Continuity engine: checks canon
src/publishing.js - Publishing → Series canon: uses series data
src/publishing.js - Book packaging → HTML output: uses HTML helpers
src/packaging.js - Book packaging → Project files: writes files
src/packaging.js - HTML output → Publishing: uses publishing data
src/html.js - Command handling → Exit status: reports command status
src/commands.js