
Story Analysis
Run a structured diagnostic on a finished short story or novel chapter to spot narrative gaps before you revise or publish.
Overview
Story Analysis is an agent skill for the Ship phase that systematically evaluates completed short stories or novel chapters against narrative goals.
Install
npx skills add https://github.com/jwynia/agent-skills --skill story-analysisWhat is this skill?
- Two analysis modes: Short Story (unity, shattering moment, resolution) and Chapter (continuity, momentum, arc contributi
- Short-story sections SA1–SA2 cover narrative foundation and character construction with explicit evaluation questions
- Diagnostic workflow: evaluate premise scope, stakes, and whether implications are explored in-story
- MIT-licensed fiction-domain evaluative skill (metadata v1.0, type diagnostic)
- Use immediately after drafting to judge whether the piece hits its narrative goals
- 2 analysis modes: Short Story and Chapter
- Short Story analysis includes SA1 (Narrative Foundation) and SA2 (Character Construction) sections
Adoption & trust: 535 installs on skills.sh; 92 GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
You finished a draft but cannot tell whether the premise, scope, characters, and payoff actually work for the length and format you chose.
Who is it for?
Indie authors and content builders who draft fiction in agents and want repeatable post-draft critique before sharing or publishing.
Skip if: Writers who need ghostwriting, plotting from zero, or marketing copy—this skill assumes a completed draft ready for evaluation.
When should I use this skill?
After drafting a completed short story or novel chapter, when you need to assess whether the piece achieves its narrative goals.
What do I get? / Deliverables
You get a structured strength-and-weakness map across narrative foundation and character construction so the next revision pass targets real gaps.
- Structured evaluation of strengths and weaknesses
- Improvement opportunities tied to narrative foundation and character construction
Recommended Skills
Journey fit
Post-draft evaluation is a quality gate—same shelf as code review, but for fiction—before you ship chapters or stories to readers. Review subphase covers systematic assessment of completed work against goals, strengths, and weaknesses.
How it compares
Use instead of one-off “critique my story” prompts when you want mode-specific checklists (short story vs chapter).
Common Questions / FAQ
Who is story-analysis for?
Solo builders and indie fiction writers who use AI coding agents for creative workflows and want systematic post-draft story review.
When should I use story-analysis?
After you complete a short story or a novel chapter—during Ship review before beta readers, serialization, or launch distribution.
Is story-analysis safe to install?
Review the Security Audits panel on this Prism page for the ingested package; the skill is diagnostic text with no built-in shell or network tools in SKILL.md.
SKILL.md
READMESKILL.md - Story Analysis
# Story Analysis Diagnostic ## Purpose Systematically evaluate completed short stories or novel chapters to identify strengths, weaknesses, and improvement opportunities. Use after drafting to assess whether the piece achieves its narrative goals. ## Quick Reference | Mode | Use For | Key Focus | |------|---------|-----------| | Short Story | Complete standalone pieces | Unity, shattering moment, resolution | | Chapter | Sections within larger work | Continuity, momentum, arc contribution | --- ## Short Story Analysis ### SA1: Narrative Foundation **Evaluate:** - Single clear premise or conflict driving the story - Scope appropriate for length - Premise integrated with plot and character - Clear implications that matter to the story **Questions:** 1. Can you state the core conflict in one sentence? 2. Is the scope right for the word count? 3. Does the premise connect to character stakes? 4. Are the implications explored within the story? --- ### SA2: Character Construction **Evaluate:** - One or two main characters with clear stakes - Efficient characterization through actions/choices - Character arcs intersecting with premise - Limited but purposeful supporting cast - Distinct voice and perspective **Questions:** 1. Who is the story about and what do they want? 2. Is character revealed through action, not description? 3. Does the character change in response to events? 4. Does every character serve a purpose? **Red Flags:** - Character described but never demonstrated - Supporting characters who don't affect anything - Stakes unclear or abstract --- ### SA3: Story Environment **Evaluate:** - Details woven into action, not exposition - Each element serves multiple purposes (setting/plot/theme) - Clear rules and limitations - Environment revealed through character interaction - Effective atmosphere and tone **Questions:** 1. Is worldbuilding shown through action or told in blocks? 2. Does each setting detail do double duty? 3. Are the story's rules clear and consistent? 4. Does the environment affect character choices? **Red Flags:** - Info-dump paragraphs - Details that never matter again - Setting that doesn't influence events --- ### SA4: The Shattering Moment **Definition:** The pivotal point that transforms everything—a moment that cannot be undone. **Must function through one approach:** - Personal revelation that transforms understanding - External event that forces change - Relationship transformation that shifts dynamics - Internal realization that cannot be undone - Cultural/social collision that demands response **For Science Fiction:** - Technology IS the shattering moment - Technology ENABLES the shattering moment - Technology PREVENTS recovery - Shattering moment CHANGES relationship with technology **Questions:** 1. Is there a clear turning point? 2. Is it connected to the core conflict? 3. Does it change the character irreversibly? 4. Does everything after feel different? --- ### SA5: Scene Structure **Evaluate:** - Scenes maximize both character and premise - Strategic balance of scene and summary - Opening hook establishes character, situation, conflict - Focused conflict from the core premise - Resolution addresses conflict while suggesting broader implications **Questions:** 1. Does every scene advance character AND plot? 2. Is the opening hook doing its job? 3. Is the conflict focused or diffuse? 4. Does the resolution satisfy while resonating beyond? --- ### SA6: Technical Execution **Economy of Detail:** - Every element serves multiple purposes - No extraneous background or world info - Exposition integrated into ac