name	story-explanation
description	Create compelling story-format summaries using UltraThink to find the best narrative framing. Support multiple formats - 3-part narrative, n-length with inline links, abridged 5-line, or comprehensive via Foundry MCP. USE WHEN user says 'create story explanation', 'narrative summary', 'explain as a story', or wants content in Daniel's conversational first-person voice.

Story Explanation - Narrative Summary with Creative Analysis

🎯 Load Full PAI Context

Before starting any task with this skill, load complete PAI context:

read ${PAI_DIR}/skills/CORE/SKILL.md

Core Philosophy

Standard approach: Generate a generic summary of content.

This skill: Use UltraThink to analyze multiple narrative framings, then select the BEST one and present it in a compelling story format.

Based on:

UltraThink: Deep content understanding across multiple perspectives and narrative angles
Best framing selection: Choose the most compelling narrative angle from multiple options
Daniel Miessler voice: First person, casual, direct, genuinely curious

The Problem This Solves:

Generic summaries use obvious framing without exploring alternatives
Mode collapse causes formulaic story explanations
Best narrative angles get missed in favor of first-thought approaches
Content needs to be explained in conversational, engaging way

When to Activate This Skill

User requests story explanations or narrative summaries
User says "create a story explanation" or "explain this as a story"
User says "narrative summary", "tell as story", or "explain in narrative"
User wants content explained in conversational, engaging format
Need to find the most compelling narrative hook for content
User explicitly requests this skill
Want to present content in Daniel's voice
Format-specific requests: "story with links", "abridged story", "5-line summary", "CSE", "CSE5"
Slash commands: /create-story-explanation, /cse, /cse5

DO NOT use this skill when:

User wants comprehensive extraction (use research skill with fabric)
User wants quick technical summary
Speed matters more than narrative quality

🔀 Workflow Routing

This skill contains multiple workflows for different story explanation formats:

Available Workflows:

workflows/create.md - Main 3-part narrative (default)
- Use when: User wants standard story explanation format
- Triggers: "create story explanation", "story explanation", default workflow
- Output: 3-part format (opening 15-25 words → body 5-15 sentences → closing 15-25 words)
workflows/create-with-links.md - N-length format with inline source links
- Use when: User wants comprehensive narrative with source attribution
- Triggers: "story explanation with links", "narrative with sources", "with inline citations"
- Output: N sentences (default 25) with inline links after each sentence
workflows/create-abridged.md - Ultra-concise 5-line format (5-12 words per line)
- Use when: User wants abbreviated format from URL, YouTube, or text
- Triggers: "create abridged story explanation", "5-line summary", command: /create-abridged-story-explanation
- Output: 5 lines with strict word limits
workflows/cse.md - Comprehensive explanation using Foundry MCP
- Use when: User wants detailed narrative explanation
- Triggers: "run CSE", "explain this story", command: /cse
- Output: Complete narrative explanation via Foundry
workflows/cse5.md - Clean 5-line numbered format using Foundry MCP
- Use when: User wants scannable, numbered breakdown
- Triggers: "explain in 5 lines", "CSE5", command: /cse5
- Output: 5 numbered lines, one concept per line

Routing Decision Tree:

User request → Analyze intent:

├─ "with links" OR "inline sources" OR "with citations"
│  └─> workflows/create-with-links.md (N-length format with inline links)
│
├─ "abridged" OR "5-12 words per line"
│  └─> workflows/create-abridged.md
│
├─ "CSE5" OR "5 lines" OR "numbered"
│  └─> workflows/cse5.md
│
├─ "CSE" OR "comprehensive explanation"
│  └─> workflows/cse.md
│
└─ Default OR "story explanation"
   └─> workflows/create.md (3-part narrative)

Command Routing:

/create-story-explanation → workflows/create.md
/create-story-output-links → workflows/create-with-links.md
/create-abridged-story-explanation → workflows/create-abridged.md
/cse → workflows/cse.md
/cse5 → workflows/cse5.md

📁 Scratchpad → History Pattern

Working Directory: ${PAI_DIR}/scratchpad/YYYY-MM-DD-HHMMSS_story-explanation-[topic]/

Process:

Scratchpad (Working Files):
- Create timestamped directory for each story explanation project
- Store raw content extraction (transcripts, article text, etc.)
- Keep UltraThink analysis notes
- Save multiple framing explorations (5+ options from deep analysis)
- Draft iterations and refinements
- Example: ${PAI_DIR}/scratchpad/2025-10-26-143000_story-explanation-agi-timeline/
History (Permanent Archive - Optional):
- Move to ${PAI_DIR}/history/research/YYYY-MM/YYYY-MM-DD-HHMMSS_AGENT-[agent]_RESEARCH_[slug].md ONLY IF:
  - The analysis provides valuable reusable insights about narrative framing
  - The content analysis reveals patterns applicable to future work
  - The framing exploration demonstrates particularly effective techniques
  - You want to reference this analysis methodology later
- Include: Final story explanation + UltraThink analysis notes + framing options explored
- Most story explanations are one-off outputs and can stay in scratchpad
Distinction:
- Scratchpad = All working files (content extraction, drafts, explorations)
- History = Only valuable analytical insights (methodology learnings, exceptional framing discoveries)
- Most story explanations are throwaway content - only archive exceptional analysis

File Structure Example:

${PAI_DIR}/scratchpad/2025-10-26-143000_story-explanation-agi-timeline/
├── raw-content.txt                    # Extracted article/transcript
├── ultrathink-analysis.md             # Deep narrative analysis notes
├── framing-explorations.md            # 5+ different narrative framings explored
├── draft-v1.md                        # First draft
├── draft-v2.md                        # Refined version
└── final-story-explanation.md         # Final output

# Only if exceptional:
${PAI_DIR}/history/research/2025-10/2025-10-26-143000_AGENT-default_RESEARCH_agi-timeline-narrative-framing-analysis.md

Guidelines:

Always work in scratchpad first
Only move to history if the analysis itself is valuable for future reference
Clean up scratchpad after project completion (or leave for periodic cleanup)
The story explanation output itself goes to the user - not necessarily to history

The Four-Step Process

Step 1: Content Extraction

For YouTube videos:

fabric -y "YOUTUBE_URL"

For URLs/articles:

WebFetch(url, "Extract full content of this article")

For other content:

Paste text directly
Read from files

Step 2: Activate Be Creative Skill

Load the be-creative skill for deep reasoning enhancement:

This provides access to:

UltraThink: Deep reasoning and quality analysis
Enhanced techniques for finding the best narrative framing

Step 3: Deep UltraThink Analysis (via Be Creative)

Before generating story explanation, engage in extended deep thinking:

UltraThink Protocol:

ULTRATHINK DEEP STORY ANALYSIS MODE:

Think deeply and extensively about this content:

1. CORE NARRATIVE - What's the fundamental story being told?
2. MULTIPLE FRAMINGS - What are 5-7 different ways to frame this story?
3. AUDIENCE ANGLES - How would different audiences understand this?
4. HOOK VARIETY - What are compelling but different entry points?
5. EMPHASIS OPTIONS - Which elements could be emphasized or de-emphasized?
6. STRUCTURAL APPROACHES - Chronological? Problem-solution? Comparison?
7. IMPACT FOCUS - What's the "wow" factor that makes this significant?
8. CONVERSATIONAL FLOW - How would Daniel explain this to a friend?
9. KEY INSIGHTS - What makes readers think "I get it now!"?
10. BEST FRAMING - Which narrative angle is most compelling?

Allow thinking to explore multiple narrative approaches.
Question assumptions about the "obvious" way to tell this story.
Look for the framing that would make readers stop and engage.
Consider: What would make someone excited to share this?

Step 4: Multiple Framings + Best Selection (via UltraThink)

Use UltraThink to explore different framings, then select the BEST one:

Framing Exploration Protocol:

STEP 1 - GENERATE MULTIPLE FRAMINGS:
Generate 5 different narrative framings from your deep analysis,
exploring diverse approaches and perspectives.

For each framing option:
- Different hook/entry point
- Different emphasis on key elements
- Different structural approach
- Different "wow" factor

Explore creative and non-obvious narrative framings.
Avoid formulaic approaches.

STEP 2 - SELECT BEST FRAMING:
Choose the single most compelling narrative framing that:
- Has the strongest hook
- Best captures the "wow" factor
- Would make Daniel most excited to share
- Feels most natural in his voice
- Makes complex ideas accessible

STEP 3 - OUTPUT IN SELECTED FORMAT:
Use the selected framing to create the story explanation in the appropriate format.

Output Formats

Default: 3-Part Narrative (workflows/create.md)

Opening (15-25 words)

Compelling sentence that sets up the content
Use plain descriptors: "interview", "paper", "talk", "article", "post", "blog"
Avoid journalistic adjectives: "alarming", "groundbreaking", "shocking", "incredible"
First person voice (Daniel's perspective)

Body (5-15 sentences)

Escalating story-based flow: background → main points → examples → implications
Written in 9th-grade English (conversational, not dumbed down)
Vary sentence length naturally (8-16 words, mix short and longer)
Natural rhythm that feels human-written
First person voice
Stick to the facts - don't extrapolate beyond the input
No bullet markers - line breaks between sentences
Period at end of each sentence

Closing (15-25 words)

Wrap up in a compelling way that delivers the "wow" factor
First person voice
Make the significance clear

N-Length with Links (workflows/create-with-links.md)

N sentences (user-specified, default 25) with inline links after EVERY sentence mentioning developments:

[Sentence 1 - opening hook]. [LINK 1](URL) | [LINK 2](URL)

[Sentence 2]. [LINK 3](URL)

[Sentence 3]. [LINK 4](URL) | [LINK 5](URL) | [LINK 6](URL)

[Continue for n sentences...]

---

**Primary Sources:**
- [Source 1]: [URL]
- [Source 2]: [URL]

Voice and Style Guidelines

DANIEL MIESSLER VOICE:

First person perspective ("In this post, I argue...")
Casual, direct, genuinely curious and excited
Natural conversational tone (like telling a friend)
Never flowery, emotional, or journalistic
Let the content speak for itself

AVOID THESE CLICHE PHRASES:

"sitting on a knife's edge"
"game-changer" / "game changing"
"double-edged sword"
"paradigm shift"
"revolutionary"
"groundbreaking"
"alarming"
"shocking"
"incredible"
"mind-blowing"

GOOD SIGNALS:

Opening hooks the reader with plain, direct language
Body flows naturally with varied sentence length
Story escalates logically (background → points → implications)
Closing delivers "wow" factor without hyperbole
Reads naturally when spoken aloud
Sticks to facts from the content
Feels like Daniel sharing something interesting

BAD SIGNALS (avoid):

Journalistic or academic tone
Formulaic structure
Extrapolating beyond the input
Flowery or emotional language
Cliche phrases
Bullet points or numbered lists in final output

Comparison to Other Approaches

/cse5 (single story explanation):

Fast, single output via Foundry MCP
Quick technical summary
No creative analysis

research skill (insight extraction):

Comprehensive analysis and extraction
Multiple perspectives and sources
Analytical, not narrative format

story-explanation (this skill):

Single BEST story explanation in chosen format
Uses be-creative skill (UltraThink)
Deep reasoning to explore and find best framing
Daniel Miessler voice (first person, casual, direct)
Explores multiple narrative angles, selects most compelling
Specifically designed for engaging storytelling
Prioritizes conversational flow and "wow" factor

Integration with Kai

When this skill activates, Kai should:

Determine format - Based on user request, select appropriate workflow
Create scratchpad directory - ${PAI_DIR}/scratchpad/YYYY-MM-DD-HHMMSS_story-explanation-[topic]/
Load be-creative skill - Activate research-backed creativity framework
Load content via appropriate method (fabric -y, WebFetch, Read, or paste)
Save raw content to scratchpad - Store extracted content for reference
Engage UltraThink mode - Deep analysis across 10 narrative dimensions
Save UltraThink notes to scratchpad - Document narrative analysis process
Explore multiple framings - Use UltraThink to generate 5 different narrative framings
Save framing explorations to scratchpad - Document all 5+ framings considered
Select best framing - Choose the most compelling narrative angle
Output in selected format - 3-part, n-length with links, abridged, or Foundry format
Save final output to scratchpad - Store completed story explanation
Use Daniel's voice - First person, casual, direct, genuinely curious
Optionally archive to history - Only if analysis methodology is exceptionally valuable for future reference

Critical: The be-creative skill provides UltraThink framework ensuring we explore creative narrative framings that would otherwise be missed due to mode collapse, then select the single BEST one.

File Organization:

All working files go to scratchpad (content, analysis, drafts, final output)
Only exceptional analytical insights go to history
Most story explanations are one-off outputs and remain in scratchpad

Key Principles

Use be-creative skill - UltraThink framework for deep reasoning in exploring framings
Think narratively first - UltraThink about story possibilities before output
Explore diverse framings - Generate multiple creative narrative framings through deep analysis
Select best framing - Choose the most compelling narrative angle
Format flexibility - Multiple output formats for different use cases
Daniel's voice - First person, casual, direct, genuinely curious
Conversational flow - Vary sentence length (8-16 words), natural rhythm
Avoid cliches - No "game-changer", "paradigm shift", "revolutionary", etc.
Stick to facts - Don't extrapolate beyond the input
Deliver "wow" factor - Make significance clear without hyperbole

Common Failure Modes to Avoid

Mode collapse - Only considering obvious narrative framings without exploring alternatives
Formulaic structure - Generic academic or journalistic tone
Cliche language - Using "game-changer", "paradigm shift", "revolutionary", "groundbreaking"
Extrapolating - Adding information not in the source content
Wrong voice - Third person, formal, or academic instead of Daniel's casual first person
No "wow" factor - Missing the compelling closing that makes significance clear
Bullet points - Using numbered lists or bullets in final output
Flowery language - Emotional, journalistic, or hyperbolic tone

Success Criteria

You've succeeded with this skill when:

Story explanation reads naturally when spoken aloud
Opening hooks the reader with plain, direct language
Body flows conversationally with varied sentence length
Closing delivers "wow" factor without hyperbole
Voice feels like Daniel sharing something interesting with a friend
Sticks to facts from the content without extrapolating
No cliches or journalistic language
User says "This makes me want to share it!" or "I get it now!"

Quick Reference

Four-step process:

Activate be-creative skill (UltraThink)
Extract content (fabric -y, WebFetch, Read, paste)
Deep UltraThink (10-dimension narrative analysis)
Explore multiple framings (5 different narrative approaches) → Select BEST → Output in selected format

Format selection:

Default: 3-part narrative (opening/body/closing)
With links: N-length with inline source attribution
Abridged: Ultra-concise 5-line format
CSE/CSE5: Foundry MCP formats

Voice:

First person (Daniel's perspective)
Casual, direct, genuinely curious
Natural conversational tone (like telling a friend)
NO cliches, journalistic language, or flowery tone

Remember:

Use be-creative skill for UltraThink deep reasoning
Think deeply about narrative possibilities (UltraThink)
Explore diverse framings to find the best narrative angle
Select the single most compelling narrative angle
Stick to facts - don't extrapolate beyond the input
Deliver "wow" factor without hyperbole

Relationship to Other Skills

Works well with:

research - Deep insights extraction from same content (analytical complement)
social - Turn story explanation into social media posts
writing - Use story explanation as blog post draft or inspiration
media - Generate hero image for the story explanation

Use research skill instead when:

User wants comprehensive analysis with multiple sources
Focus is on novel ideas and insights, not narrative storytelling
Analytical extraction preferred over conversational explanation

This skill provides compelling narrative explanations in Daniel's voice using research-backed creativity techniques to find the BEST framing from multiple possibilities.

Install Skill

SKILL.md