jwynia/agent-skillsMIT1 file

Story Analysis

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.

Specification
Skill ID
jwynia/agent-skills/story-analysis
Publisher
jwynia
Repository
agent-skills
Installs
0
Files
1
License
MIT
Synced
Sep 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

jwynia/agent-skills/story-analysisInstalls these files
  • SKILL.md

What this skill tells the agent

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

ModeUse ForKey Focus
Short StoryComplete standalone piecesUnity, shattering moment, resolution
ChapterSections within larger workContinuity, 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 action
  • Clear connection between details and story purpose

Point of View:

  • Consistent and purposeful POV choice
  • Viewpoint optimal for revealing character and premise
  • Minimal POV shifts
  • Clear character perspective on events
  • Effective narrative distance

Language and Voice:

  • Consistent tone throughout
  • Purposeful dialogue
  • Effective subtext
  • Style serves story purpose
  • Distinct narrative voice

SA7: Emotional Architecture

Tension Management:

  • Clear emotional throughline
  • Strategic building and release
  • Effective pacing of reveals
  • Balance of explicit and implicit

Reader Engagement:

  • Clear emotional stakes
  • Strategic use of empathy
  • Meaningful emotional payoff
  • Effective use of subtext

Questions:

  1. Is there a clear emotional journey?
  2. Does tension build appropriately?
  3. Is the emotional payoff earned?
  4. What remains unspoken but felt?

SA8: Thematic Resolution

Evaluate:

  • Character arc completion
  • Premise implications addressed
  • Immediate conflict resolved
  • Larger questions remain thought-provoking

Questions:

  1. Is the character arc complete?
  2. Are the premise implications explored?
  3. Is the immediate conflict resolved?
  4. Does the story linger in the mind?

Novel Chapter Analysis

CA1: Position in Narrative Arc

Evaluate:

  • Chapter's specific role in overall structure
  • Contribution to plot progression
  • Advancement of character development arcs
  • Thematic development within larger work

Questions:

  1. What is this chapter's job in the novel?
  2. What plot progress happens here?
  3. What character progress happens here?
  4. How does it develop the theme?

CA2: Narrative Momentum

Evaluate:

  • Opening hook's connection to previous chapter
  • Tension management across chapter breaks
  • Balance of resolution and open questions
  • Strength of chapter ending propulsion
  • Questions answered vs. questions raised

Questions:

  1. Does the opening connect to what came before?
  2. Does the ending make readers want to continue?
  3. What questions does this chapter answer?
  4. What new questions does it raise?

Red Flags:

  • Chapter ends at natural stopping point (too easy to put down)
  • Opening ignores previous chapter's energy
  • All questions answered, no forward pull

CA3: Plot Threading

Evaluate:

  • Ongoing plot threads advanced
  • New plot threads introduced
  • Plot elements resolved
  • Setup for future chapters
  • Connection to primary and secondary arcs

Track: | Thread | Status This Chapter | |--------|---------------------| | Main plot | Advanced / Setup / Resolved | | Subplot A | Advanced / Setup / Resolved | | Subplot B | Advanced / Setup / Resolved |


CA4: Character Continuity

Evaluate:

  • Progress on character arcs from previous chapters
  • New character aspects revealed
  • Relationship evolution
  • Setup for future development
  • Consistency with established traits

Questions:

  1. How has this character changed since chapter 1?
  2. What new facets are revealed here?
  3. How do relationships shift?
  4. Is the character consistent with who they've been?

CA5: POV and Voice

Evaluate:

  • Consistency with established POV patterns
  • Effective transitions between viewpoints (if multiple)
  • Depth of penetration into character perspective
  • Balance of internal and external narrative
  • Voice and tone alignment with overall narrative

CA6: Information Flow

Evaluate:

  • Balance of new and established information
  • Strategic revelation of background elements
  • Management of reader vs. character knowledge
  • Setup of future revelations
  • Integration of necessary exposition

CA7: Pacing Elements

Evaluate:

  • Chapter's pace relative to surrounding chapters
  • Internal pacing structure
  • Tension development and release
  • Scene length and rhythm
  • Strategic use of time

CA8: Connection Tracking

Previous Chapter:

  • Immediate continuity elements
  • Tension carryover
  • Question resolution
  • Thread advancement

Next Chapter:

  • Setup elements planted
  • Tension building toward
  • Questions raised
  • Threads advanced

Broader Novel:

  • Major arc advancement
  • Theme development
  • Character arc progression
  • World development contribution

Evaluation Checklists

Short Story Checklist

Use this skill in a project

Open any RiverX project, search the Skills panel for jwynia/agent-skills/story-analysis, and install it in one click.

Use this skill