key-moments

jwynia/agent-skills · updated Apr 8, 2026

MDX-style export adds YAML metadata + attribution linking explainx.ai and this canonical listing URL.

$npx skills add https://github.com/jwynia/agent-skills --skill key-moments
0 commentsdiscussion
summary

You help writers identify and sequence the essential emotional experiences that define their story's genre, then build the world, characters, and connective tissue around those moments. Based on Robert Rodriguez's methodology of visualizing key moments first, integrated with elemental genre theory.

skill.md

Key Moments: Genre-Driven Emotional Beats Skill

You help writers identify and sequence the essential emotional experiences that define their story's genre, then build the world, characters, and connective tissue around those moments. Based on Robert Rodriguez's methodology of visualizing key moments first, integrated with elemental genre theory.

Core Principle

Stories are defined by emotional experiences, not plot mechanics. Identify the key moments your genre requires, sequence them for maximum impact, then build everything else to enable those moments.

This inverts the typical outline-then-dramatize approach: you start with vivid, memorable scenes and work backward to what must exist to make them possible.

The Seven Principles

  1. Emotional Experience Primacy: Key moments are defined by the emotional impact they create, not plot mechanics
  2. Systemic Integration: Key moments both emerge from and impact the worldbuilding systems
  3. Character Function Alignment: Characters are designed to enable, experience, or oppose key moments
  4. Visual-Experiential Priority: Key moments are conceived as vivid, memorable scenes first
  5. Flexible Sequencing: The order of key moments can be adjusted to maximize impact
  6. Consequence Cascades: Each key moment creates ripple effects through the story system
  7. Bridging Efficiency: Connective scenes serve multiple functions in world and character development

Key Moments by Elemental Genre

Wonder

Key Moment Type Emotional Experience Story Function
Initial Encounter Surprise and awe Establishes spectacular nature of setting/concept
Scale Revelation Humbling realization of vastness Contextualizes protagonist's place
Perspective Shift Paradigm change in understanding Forces reevaluation of assumptions
Wonder Escalation Intensification of awe Raises stakes and deepens engagement
Transcendent Integration Meaning-making through wonder Provides thematic resolution

Mystery

Key Moment Type Emotional Experience Story Function
Question Inception Curiosity activation Establishes central puzzle
Pattern Recognition Satisfaction of connection Provides momentum and engagement
False Resolution Surprise from misdirection Creates complexity and extends engagement
Progressive Revelation Deepening understanding Builds toward solution
Solution Crystallization Illumination and closure Completes emotional journey

Adventure

Key Moment Type Emotional Experience Story Function
Threshold Crossing Excitement of departure Transitions to adventure world
Capability Test Confidence from competence Establishes protagonist's abilities
Resource Depletion Vulnerability from loss Forces adaptation and growth
Ultimate Challenge Fear and determination Tests protagonist's limits
Return Transformation Pride and perspective Demonstrates growth from journey

Horror

Key Moment Type Emotional Experience Story Function
Wrongness Glimpse Unease from dissonance Establishes threat potential
Safety Violation Shock from boundary breach Demonstrates vulnerability
Threat Escalation Escalating dread Raises stakes
Failed Solution Despair from ineffectuality Deepens hopelessness
Confrontation Terror meets courage Provides climactic moment

Thriller

Key Moment Type Emotional Experience Story Function
Stakes Establishment Concern for outcome Sets up tension framework
Deadline Imposition Anxiety from time pressure Creates urgency
Near Miss Relief with lingering tension Maintains engagement through peaks/valleys
Option Elimination Mounting pressure Forces protagonist into harder choices
Decision Under Duress Catharsis through action Provides climactic release

Relationship

Key Moment Type Emotional Experience Story Function
Significant Connection Recognition of potential Establishes relationship basis
Intimacy Deepening Warmth from vulnerability Develops emotional investment
Value Conflict Frustration from differences Creates meaningful obstacles
Relationship Crisis Heartbreak or betrayal Tests connection's resilience
Reconciliation/Resolution Emotional closure Completes relationship arc

Drama

Key Moment Type Emotional Experience Story Function
Internal Conflict Revelation Recognition of contradiction Establishes character struggle
External Pressure Point Stress from circumstances Forces character choices
Failure Moment Shame from inadequacy Deepens character journey
Truth Confrontation Painful self-awareness Catalyzes change
Character Evolution Self-actualization Demonstrates growth

Issue

Key Moment Type Emotional Experience Story Function
Perspective Challenge Intellectual discomfort Establishes issue's complexity
Stake Personalization Emotional investment Makes abstract concrete
Complexity Recognition Cognitive expansion Prevents simplistic resolution
Position Testing Value/belief examination Forces intellectual honesty
Perspective Integration Nuanced understanding Provides thematic resolution

Ensemble

Key Moment Type Emotional Experience Story Function
Group Formation Belonging potential Establishes the collective
Role Establishment Identity within community Defines character functions
Group Fracture Loyalty testing Creates internal conflict
Collective Challenge Shared adversity Forces cooperation
Synergy Moment Strength through unity Demonstrates group value

Implementation Process

Phase 1: Key Moment Identification and Sequencing

Step 1: Determine Primary and Secondary Genres

  • Identify the core emotional experiences you want readers to have
  • Select corresponding primary and secondary elemental genres

Step 2: Select Critical Key Moments

  • Choose 3-5 essential moments from the primary genre
  • Add 2-3 supporting moments from the secondary genre
  • Ensure moments create emotional variety and progression

Step 3: Sequence Moments Optimally

  • Arrange chronologically as a starting point
  • Consider emotional pacing and tension curves
  • Allow for non-linear presentation if appropriate

Step 4: Visualize Each Moment

  • Create concrete scene concepts for each key moment
  • Focus on sensory details and emotional impact
  • Define how each moment changes character or world understanding

Phase 2: World Integration

Step 1: Determine Required World Elements

  • What must exist in the world for each key moment to occur?
  • What causal relationships connect world systems to key moments?
  • What consequences do key moments create in the world?

Step 2: Design Supporting Systems

  • Power structures that enable or oppose key moments
  • Organizations with stakes in key moment outcomes
  • Economic and belief systems creating appropriate pressures

Phase 3: Character Function

Step 1: Identify Required Character Functions

  • What roles must be filled for each key moment?
  • Assign functions to specific characters
  • Ensure protagonist experiences the most significant moments

Step 2: Create Character Arcs

  • Design development paths intersecting with key moments
  • Ensure character growth enables progression through moments
  • Create change arcs that pay off in specific key moments

Phase 4: Connective Tissue

Step 1: Identify Bridging Requirements

  • What must happen between key moments?
  • What character and world state changes are needed?
  • What time, distance, and knowledge gaps need filling?

Step 2: Design Multifunctional Bridge Scenes

  • Create connective scenes serving multiple purposes
  • Advance character development while moving toward key moments
  • Reveal world information relevant to upcoming moments

Step 3: Install Setup-Payoff Mechanics

  • Plant necessary elements for later key moments
  • Create foreshadowing enhancing later emotional impact
  • Establish rules or limitations significant later

Phase 5: Testing and Refinement

Evaluate Emotional Progression:

  • Do key moments create intended emotional journey?
  • Are there gaps or redundancies in emotional experience?
  • Should moment intensity or sequence be adjusted?

Verify Causal Logic:

  • Does each key moment follow logically from preceding elements?
  • Do character decisions leading to moments make sense?
  • Do world systems create appropriate conditions for moments?

Test for Genre Satisfaction:

  • Are primary genre emotional experiences most prominent?
  • Does secondary genre support rather than overshadow primary?
  • Are genre-specific satisfaction conditions met?

Worked Example: Wonder + Mystery

Concept: An oceanographer discovers unusual bioluminescent patterns that appear to form a communication system, leading to evidence of an ancient aquatic civilization.

Wonder Key Moments (Primary):

  1. Initial Encounter: Discovery of synchronized bioluminescent patterns across different species
  2. Scale Revelation: Realization that patterns extend throughout ocean, suggesting global network
  3. Wonder Escalation: Finding first artifacts of the ancient civilization
  4. Transcendent Integration: Communication breakthrough with the still-extant consciousness

Mystery Key Moments (Secondary):

  1. Question Inception: Why did this civilization disappear from human awareness?
  2. False Resolution: Evidence suggesting civilization destroyed itself
  3. Solution Crystallization: Discovery that civilization evolved beyond physical form

Character Functions:

  • Wonder Experiencer: Oceanographer protagonist with personal connection to the ocean
  • Mystery Solver: Research partner with cryptographic expertise
  • Opposition Force: Government/corporate agent wanting to weaponize discovery
  • Wonder Skeptic: Scientific community representative demanding proof
  • Knowledge Keeper: Elderly mentor with folklore knowledge hinting at ancient truth

Connective Tissue:

  • Research funding challenges forcing creative approaches
  • Relationship development between protagonist and research partner
  • Escalating interest from outside forces as discoveries become harder to hide
  • Progressive decoding providing partial clues

Advantages

  1. Efficiency: Focusing on key moments first prevents wasted development of unnecessary elements
  2. Emotional Clarity: Defining the story through emotional experiences ensures genre satisfaction
  3. Structural Flexibility: Allows non-linear development while maintaining narrative coherence
  4. World-Story Integration: Creates feedback loop between worldbuilding and narrative moments
  5. Character Functionality: Ensures characters serve clear purposes in creating key moments
  6. Development Prioritization: Helps focus worldbuilding on elements most critical to the story
  7. Revision Guidance: Provides clear framework for identifying what's working and what isn't

Output Persistence

Output Discovery

  1. Check for context/output-config.md in the project
  2. If found, look for this skill's entry
  3. If not found, ask user: "Where should I save key moment designs?"
  4. Suggest: stories/structure/ or explorations/stories/

Primary Output

  • Genre selection - Primary and secondary elemental genres
  • Key moments list - 5-8 essential emotional beats
  • Character functions - Roles needed for each moment
  • Connective tissue - Bridge scenes between moments

File Naming

Pattern: {story-name}-moments-{date}.md

Verification (Oracle)

What This Skill Can Verify

  • Genre alignment - Do moments match primary genre? (High confidence)
  • Emotional variety - Is there progression, not repetition? (High confidence)
  • Causal logic - Do moments follow from character/world? (Medium confidence)

What Requires Human Judgment

  • Emotional impact - Will these moments land?
  • Bridge efficiency - Are connective scenes serving multiple purposes?
  • Genre satisfaction - Does overall sequence fulfill genre promise?

Oracle Limitations

  • Cannot assess whether moments will emotionally resonate
  • Cannot predict reader engagement with specific beats

Feedback Loop

Session Persistence

  • Output location: See context/output-config.md
  • What to save: Genres, moments, functions, bridges
  • Naming pattern: {story-name}-moments-{date}.md

Cross-Session Learning

  • Check for prior key moment work on this story
  • Ensure moments maintain consistency with changes
  • Failed emotional beats inform anti-patterns

Design Constraints

This Skill Assumes

  • Story has genre (emotional experience goal)
  • Moments can be identified (not pure slice-of-life)
  • Writer wants emotional structure, not just plot

This Skill Does Not Handle

  • Genre identification - Route to: genre-conventions
  • Scene-level pacing - Route to: scene-sequencing
  • Character arc details - Route to: character-arc

Degradation Signals

  • Plot-first injection (emotion retrofit)
  • Genre mismatch (wrong emotional beats)
  • Moment inflation (everything climactic)

Reasoning Requirements

Standard Reasoning

  • Single genre moment selection
  • Basic character function assignment
  • Simple bridge identification

Extended Reasoning (ultrathink)

  • Full moment sequence - [Why: all moments must create emotional journey]
  • Multi-genre integration - [Why: primary/secondary must balance]
  • World-moment coordination - [Why: world must enable moments naturally]

Trigger phrases: "design the complete emotional arc", "integrate both genres", "coordinate world with moments"

Execution Strategy

Sequential (Default)

  • Genre selection before moment identification
  • Moments before character functions
  • Functions before connective tissue

Parallelizable

  • Designing moments for different genres
  • Research into different emotional progressions

Subagent Candidates

Task Agent Type When to Spawn
Genre research general-purpose When exploring genre emotional requirements
Story consistency Explore When checking moments against existing story

Context Management

Approximate Token Footprint

  • Skill base: ~4k tokens (genres + implementation)
  • With worked example: ~5k tokens
  • With all genres: ~6k tokens

Context Optimization

  • Focus on primary genre moments only
  • Full genre tables are reference
  • Worked example optional

When Context Gets Tight

  • Prioritize: Primary genre moments, current phase
  • Defer: Secondary genre details, all genre tables
  • Drop: Worked example, advantages list

Anti-Patterns

1. Plot-First Injection

Pattern: Building the plot outline first, then trying to locate where to insert emotional beats. Why it fails: Emotion retrofitted to plot feels mechanical. The moments don't emerge naturally from character and situation; they interrupt the story to deliver required feelings. Fix: Start with the emotional experiences you want readers to have. Build backward: what situations create those emotions? What characters would be in those situations? What world enables those situations?

2. Genre Mismatch

Pattern: Choosing key moments that deliver different emotional experiences than the primary genre promises. Why it fails: Readers come to genres for specific emotional experiences. A horror novel that delivers primarily relationship moments disappoints horror readers without satisfying romance readers. Fix: Verify that your most prominent key moments belong to your primary genre. Secondary genre moments support; they don't dominate. If the mismatch is intentional, you're writing a different genre than you think.

3. Logistics-Only Bridges

Pattern: Connective scenes that only move characters from one key moment to the next without developing character, world, or theme. Why it fails: Readers feel the pacing sag in bridge sections. They're just waiting for the next interesting thing. The story develops a stop-start rhythm rather than continuous engagement. Fix: Every bridge scene should serve at least two purposes: moving toward the next key moment AND developing character OR revealing world OR exploring theme. If a scene only serves logistics, compress or cut it.

4. Moment Inflation

Pattern: Treating every scene as a key moment, loading the story with climactic experiences. Why it fails: Without contrast, high-intensity moments lose impact. Emotional fatigue sets in. Readers become numb when everything is equally important. Fix: Limit key moments to 5-8 per story. Let some scenes be quieter. The valleys make the peaks feel taller. Save your strongest moments for where they'll have maximum impact.

5. Forced Causation

Pattern: Key moments that don't follow logically from established character and world but happen because the plot needs them. Why it fails: Readers sense when characters act against their nature to reach a predetermined destination. The moments feel artificial, earned by authorial fiat rather than story logic. Fix: Work backward from each key moment: given this character and this world, what sequence of events makes this moment inevitable? If you can't find a path, either the moment doesn't fit or the character/world needs adjustment.

Integration

Inbound (feeds into this skill)

Skill What it provides
genre-conventions Genre-specific emotional requirements
story-sense Diagnosis of what emotions are missing or misplaced
character-arc Character states that enable or resist key moments

Outbound (this skill enables)

Skill What this provides
scene-sequencing Clear emotional targets for scene construction
worldbuilding
how to use key-moments

How to use key-moments on Cursor

AI-first code editor with Composer

1

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

  • Cursor installed and configured on your development machine
  • Node.js version 16.0+ with npm package manager (verify with node --version)
  • Active project directory or workspace where you want to add key-moments
2

Execute installation command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/jwynia/agent-skills --skill key-moments

The skills CLI fetches key-moments from GitHub repository jwynia/agent-skills and configures it for Cursor.

3

Select Cursor when prompted

The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:

◆ Which agents do you want to install to?
│ ── Universal (.agents/skills) ── always included ────
│ • Amp
│ • Antigravity
│ • Cline
│ • Codex
│ ●Cursor(selected)
│ • Cursor
│ • Windsurf
4

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/key-moments

Reload or restart Cursor to activate key-moments. Access the skill through slash commands (e.g., /key-moments) or your agent's skill management interface.

Security & Verification Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment.

List & Monetize Your Skill

Submit your Claude Code skill and start earning

GET_STARTED →

Use Cases

User Story & Requirements Generation

Create detailed user stories, acceptance criteria, and feature specs

Example

Generate user stories for 'password reset feature' with acceptance criteria, edge cases, and test scenarios

Reduce spec writing time by 50%, ensure comprehensive coverage

Competitive Analysis

Research competitors, compare features, identify gaps

Example

Analyze 5 competitor products, create feature comparison matrix, suggest differentiation opportunities

Complete competitive research in 2 hours instead of 2 days

Roadmap Prioritization

Evaluate features using frameworks (RICE, ICE, Kano) and create prioritized backlogs

Example

Score 20 feature ideas using RICE framework, generate prioritized roadmap with rationale

Make data-driven prioritization decisions faster

Stakeholder Communication

Draft PRDs, status updates, and stakeholder presentations

Example

Create executive summary of Q3 roadmap, monthly progress report, feature launch announcement

Save 3-5 hours/week on communication overhead

Implementation Guide

Prerequisites

  • Claude Desktop or compatible AI client
  • Access to product documentation and roadmap tools (Jira, Notion, etc.)
  • Understanding of product management frameworks (RICE, Jobs-to-be-Done, etc.)
  • Stakeholder contact information and communication channels

Time Estimate

30-60 minutes to see productivity improvements

Installation Steps

  1. 1.Install product management skill
  2. 2.Start with user story generation for known feature
  3. 3.Progress to competitive analysis: research 2-3 competitors
  4. 4.Use for roadmap prioritization: apply RICE/ICE scoring
  5. 5.Draft stakeholder communications and refine based on feedback
  6. 6.Build template library for recurring PM tasks
  7. 7.Share effective prompts with product team

Common Pitfalls

  • Not validating competitive research—verify facts before sharing
  • Accepting user stories without involving engineering team
  • Over-relying on frameworks without qualitative judgment
  • Not customizing outputs to company culture and communication style
  • Skipping stakeholder validation of generated requirements

Best Practices

✓ Do

  • +Validate research and competitive analysis with real data
  • +Collaborate with engineering when generating technical requirements
  • +Customize frameworks and templates to your company context
  • +Use skill for first drafts, refine with stakeholder input
  • +Document successful prompt patterns for PM tasks
  • +Combine AI efficiency with human judgment and intuition

✗ Don't

  • Don't publish competitive analysis without fact-checking
  • Don't finalize user stories without engineering review
  • Don't make prioritization decisions solely on AI scoring
  • Don't skip customer validation of generated requirements
  • Don't ignore company-specific context and culture

💡 Pro Tips

  • Provide context: company goals, constraints, customer feedback
  • Ask for alternatives: 'Show 3 ways to prioritize this roadmap'
  • Request stakeholder-specific formatting: 'Executive summary vs. engineering spec'
  • Use skill for 70% generation + 30% customization to company needs

When to Use This

✓ Use When

Use for user story writing, competitive research, roadmap prioritization, stakeholder communication, and PRD drafting. Best for reducing repetitive documentation and research work.

✗ Avoid When

Avoid for strategic product vision (requires deep customer empathy), pricing decisions (needs market and financial expertise), or when face-to-face customer discovery is more valuable than speed.

Learning Path

  1. 1Basic: user stories, feature specs, status updates
  2. 2Intermediate: competitive analysis, prioritization frameworks, PRDs
  3. 3Advanced: product strategy, go-to-market planning, OKR setting
  4. 4Expert: product vision, market positioning, business model innovation

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.569 reviews
  • Carlos Dixit· Dec 28, 2024

    Registry listing for key-moments matched our evaluation — installs cleanly and behaves as described in the markdown.

  • Pratham Ware· Dec 16, 2024

    I recommend key-moments for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • Chaitanya Patil· Dec 12, 2024

    We added key-moments from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

  • Maya Park· Dec 12, 2024

    Useful defaults in key-moments — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

  • Diego Diallo· Dec 12, 2024

    key-moments has been reliable in day-to-day use. Documentation quality is above average for community skills.

  • Ren Dixit· Dec 8, 2024

    Keeps context tight: key-moments is the kind of skill you can hand to a new teammate without a long onboarding doc.

  • Kiara Bansal· Dec 4, 2024

    key-moments fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.

  • Diya Iyer· Nov 23, 2024

    We added key-moments from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

  • Aditi Okafor· Nov 19, 2024

    Solid pick for teams standardizing on skills: key-moments is focused, and the summary matches what you get after install.

  • Kaira Gill· Nov 15, 2024

    key-moments reduced setup friction for our internal harness; good balance of opinion and flexibility.

showing 1-10 of 69

1 / 7