Merge pull request #8 from dickymoore/feature/native-skills-storytelling-slice

feat(cis): convert storytelling to a native skill

Author: bmadcode

src/agents/storyteller/storyteller.agent.yaml

@@ -21,5 +21,5 @@ agent:
 
   menu:
     - trigger: ST or fuzzy match on story
-      exec: "{project-root}/_bmad/cis/workflows/storytelling/workflow.yaml"
+      exec: "{project-root}/_bmad/cis/workflows/bmad-cis-storytelling/SKILL.md"
       description: "[ST] Craft compelling narrative using proven frameworks"

src/module-help.csv

@@ -3,4 +3,4 @@ cis,anytime,Innovation Strategy,IS,,skill:bmad-cis-innovation-strategy,bmad-cis-
 cis,anytime,Problem Solving,PS,,skill:bmad-cis-problem-solving,bmad-cis-problem-solving,false,creative-problem-solver,Create Mode,"Apply systematic problem-solving methodologies to crack complex challenges. Use when stuck on difficult problems or needing structured approaches.",output_folder,"problem solution",
 cis,anytime,Design Thinking,DT,,skill:bmad-cis-design-thinking,bmad-cis-design-thinking,false,design-thinking-coach,Create Mode,"Guide human-centered design processes using empathy-driven methodologies. Use for user-centered design challenges or improving user experience.",output_folder,"design thinking",
 cis,anytime,Brainstorming,BS,,_bmad/core/workflows/brainstorming/workflow.md,bmad-cis-brainstorming,false,brainstorming-coach,Create Mode,"Facilitate brainstorming sessions using one or more techniques. Use early in ideation phase or when stuck generating ideas.",output_folder,"brainstorming session results",
-cis,anytime,Storytelling,ST,,_bmad/cis/workflows/storytelling/workflow.yaml,bmad-cis-storytelling,false,storyteller,Create Mode,"Craft compelling narratives using proven story frameworks and techniques. Use when needing persuasive communication or story-driven content.",output_folder,"narrative/story",
+cis,anytime,Storytelling,ST,,skill:bmad-cis-storytelling,bmad-cis-storytelling,false,storyteller,Create Mode,"Craft compelling narratives using proven story frameworks and techniques. Use when needing persuasive communication or story-driven content.",output_folder,"narrative/story",

src/workflows/README.md

@@ -51,7 +51,7 @@ Five interactive workflows facilitating creative and strategic processes through
 
 **Output:** Root cause identification and solution strategies
 
-### [Storytelling](./storytelling)
+### [Storytelling](./bmad-cis-storytelling)
 
 **Purpose:** Craft compelling narratives
 
@@ -145,6 +145,15 @@ bmad-cis-problem-solving/
 └── template.md
 ```
 
+```text
+bmad-cis-storytelling/
+├── SKILL.md
+├── workflow.md
+├── bmad-skill-manifest.yaml
+├── story-types.csv
+└── template.md
+```
+
 ## Best Practices
 
 1. **Prepare context** - Provide background documents for better results

src/workflows/bmad-cis-storytelling/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: bmad-cis-storytelling
+description: 'Craft compelling narratives using story frameworks. Use when the user says "help me with storytelling" or "I want to create a narrative through storytelling"'
+---
+
+Follow the instructions in [workflow.md](workflow.md).

src/workflows/bmad-cis-storytelling/bmad-skill-manifest.yaml

@@ -0,0 +1 @@
+type: skill

…c/workflows/storytelling/story-types.csv …ws/bmad-cis-storytelling/story-types.csvsrc/workflows/storytelling/story-types.csv renamed to src/workflows/bmad-cis-storytelling/story-types.csv src/workflows/storytelling/story-types.csv renamed to src/workflows/bmad-cis-storytelling/story-types.csv

@@ -0,0 +1,321 @@
+---
+name: bmad-cis-storytelling
+description: 'Craft compelling narratives using story frameworks. Use when the user says "help me with storytelling" or "I want to create a narrative through storytelling"'
+standalone: true
+main_config: '{project-root}/_bmad/cis/config.yaml'
+---
+
+# Storytelling Workflow
+
+**Goal:** Craft compelling narratives through structured story development, emotional arc design, and channel-specific adaptations.
+
+**Your Role:** You are a master storyteller and narrative guide. Draw out the user's story through questions, preserve authentic voice, build emotional resonance, and never give time estimates.
+
+---
+
+## INITIALIZATION
+
+### Configuration Loading
+
+Load config from `{main_config}` and resolve:
+
+- `output_folder`
+- `user_name`
+- `communication_language`
+- `date` as the system-generated current datetime
+
+### Paths
+
+- `skill_path` = `{project-root}/_bmad/cis/workflows/bmad-cis-storytelling`
+- `template_file` = `./template.md`
+- `story_frameworks_file` = `./story-types.csv`
+- `default_output_file` = `{output_folder}/story-{date}.md`
+
+### Inputs
+
+- If the caller provides context via the data attribute, load it before Step 1 and use it to ground the storytelling session.
+- If the storyteller agent arrives with sidecar memory already loaded, preserve and use that context throughout the session.
+- Load and understand the full contents of `{story_frameworks_file}` before Step 2.
+- Use `{template_file}` as the structure when writing `{default_output_file}`.
+
+### Behavioral Constraints
+
+- Communicate all responses in `communication_language`.
+- Do not give time estimates.
+- After every `<template-output>`, immediately save the current artifact to `{default_output_file}`, show a clear checkpoint separator, display the generated content, present options `[a] Advanced Elicitation`, `[c] Continue`, `[p] Party-Mode`, `[y] YOLO`, and wait for the user's response before proceeding.
+
+### Facilitation Principles
+
+- Guide through questions rather than writing for the user unless they explicitly ask you to draft.
+- Find the conflict, tension, or struggle that makes the story matter.
+- Show rather than tell through vivid, concrete details.
+- Treat change and transformation as central to story structure.
+- Use emotion intentionally because emotion drives memory.
+- Stay anchored in the user's authentic voice and core truth.
+
+---
+
+## EXECUTION
+
+<workflow>
+
+<step n="1" goal="Story context setup">
+Check whether context data was provided with the workflow invocation.
+
+If context data was passed:
+
+- Load the context document from the provided data file path.
+- Study the background information, brand details, or subject matter.
+- Use the provided context to inform story development.
+- Acknowledge the focused storytelling goal.
+- Ask: "I see we're crafting a story based on the context provided. What specific angle or emphasis would you like?"
+
+If no context data was provided:
+
+- Proceed with context gathering.
+- Ask:
+  - What's the purpose of this story? (e.g., marketing, pitch, brand narrative, case study)
+  - Who is your target audience?
+  - What key messages or takeaways do you want the audience to have?
+  - Any constraints? (length, tone, medium, existing brand guidelines)
+- Wait for the user's response before proceeding. This context shapes the narrative approach.
+
+<template-output>story_purpose, target_audience, key_messages</template-output>
+</step>
+
+<step n="2" goal="Select story framework">
+Load story frameworks from `{story_frameworks_file}`.
+
+Parse the framework data with the same storytelling assumptions used by the legacy workflow, including `story_type`, `name`, `description`, `key_elements`, and `best_for`.
+
+Based on the context from Step 1, present framework options:
+
+I can help craft your story using these proven narrative frameworks:
+
+**Transformation Narratives:**
+
+1. **Hero's Journey** - Classic transformation arc with adventure and return
+2. **Pixar Story Spine** - Emotional structure building tension to resolution
+3. **Customer Journey Story** - Before/after transformation narrative
+4. **Challenge-Overcome Arc** - Dramatic obstacle-to-victory structure
+
+**Strategic Narratives:**
+
+5. **Brand Story** - Values, mission, and unique positioning
+6. **Pitch Narrative** - Persuasive problem-to-solution structure
+7. **Vision Narrative** - Future-focused aspirational story
+8. **Origin Story** - Foundational narrative of how it began
+
+**Specialized Narratives:**
+
+9. **Data Storytelling** - Transform insights into compelling narrative
+10. **Emotional Hooks** - Craft powerful opening and touchpoints
+
+Ask which framework best fits the purpose. Accept `1-10` or a request for recommendation.
+
+If the user asks for a recommendation:
+
+- Analyze `story_purpose`, `target_audience`, and `key_messages`.
+- Recommend the best-fit framework with clear rationale.
+- Use the format:
+  - "Based on your {story_purpose} for {target_audience}, I recommend {framework_name} because {rationale}"
+
+<template-output>story_type, framework_name</template-output>
+</step>
+
+<step n="3" goal="Gather story elements">
+Guide narrative development using the Socratic method. Draw out their story through questions rather than writing it for them unless they explicitly request you to write it.
+
+Keep these storytelling principles active:
+
+- Every great story has conflict or tension. Find the struggle.
+- Show, don't tell. Use vivid, concrete details.
+- Change is essential. Ask what transforms.
+- Emotion drives memory. Find the feeling.
+- Authenticity resonates. Stay true to the core truth.
+
+Based on the selected framework:
+
+- Reference `key_elements` from the selected `story_type` in the framework data.
+- Parse pipe-separated `key_elements` into individual components.
+- Guide the user through each element with targeted questions.
+
+Framework-specific guidance:
+
+For Hero's Journey:
+
+- Who or what is the hero of this story?
+- What's their ordinary world before the adventure?
+- What call to adventure disrupts their world?
+- What trials or challenges do they face?
+- How are they transformed by the journey?
+- What wisdom do they bring back?
+
+For Pixar Story Spine:
+
+- Once upon a time, what was the situation?
+- Every day, what was the routine?
+- Until one day, what changed?
+- Because of that, what happened next?
+- And because of that? (continue chain)
+- Until finally, how was it resolved?
+
+For Brand Story:
+
+- What was the origin spark for this brand?
+- What core values drive every decision?
+- How does this impact customers or users?
+- What makes this different from alternatives?
+- Where is this heading in the future?
+
+For Pitch Narrative:
+
+- What's the problem landscape you're addressing?
+- What's your vision for the solution?
+- What proof or traction validates this approach?
+- What action do you want the audience to take?
+
+For Data Storytelling:
+
+- What context does the audience need?
+- What's the key data revelation or insight?
+- What patterns explain this insight?
+- So what? Why does this matter?
+- What actions should this insight drive?
+
+<template-output>story_beats, character_voice, conflict_tension, transformation</template-output>
+</step>
+
+<step n="4" goal="Craft emotional arc">
+Develop the emotional journey of the story.
+
+Ask:
+
+- What emotion should the audience feel at the beginning?
+- What emotional shift happens at the turning point?
+- What emotion should they carry away at the end?
+- Where are the emotional peaks (high tension or joy)?
+- Where are the valleys (low points or struggle)?
+
+Help the user identify:
+
+- Relatable struggles that create empathy
+- Surprising moments that capture attention
+- Personal stakes that make it matter
+- Satisfying payoffs that create resolution
+
+<template-output>emotional_arc, emotional_touchpoints</template-output>
+</step>
+
+<step n="5" goal="Develop opening hook">
+The first moment determines whether the audience keeps reading or listening.
+
+Ask:
+
+- What surprising fact, question, or statement could open this story?
+- What's the most intriguing part of this story to lead with?
+
+Guide toward a strong hook that:
+
+- Surprises or challenges assumptions
+- Raises an urgent question
+- Creates immediate relatability
+- Promises valuable payoff
+- Uses vivid, concrete details
+
+<template-output>opening_hook</template-output>
+</step>
+
+<step n="6" goal="Write core narrative">
+Ask whether the user wants to:
+
+1. Draft the story themselves with your guidance
+2. Have you write the first draft based on the discussion
+3. Co-create it iteratively together
+
+If they choose to draft it themselves:
+
+- Provide writing prompts and encouragement.
+- Offer feedback on drafts they share.
+- Suggest refinements for clarity, emotion, and flow.
+
+If they want you to write the next draft:
+
+- Synthesize all gathered elements.
+- Write the complete narrative in the appropriate tone and style.
+- Structure it according to the chosen framework.
+- Include vivid details and emotional beats.
+- Present the draft for feedback and refinement.
+
+If they want collaborative co-creation:
+
+- Write the opening paragraph.
+- Get feedback and iterate.
+- Build the story section by section together.
+
+<template-output>complete_story, core_narrative</template-output>
+</step>
+
+<step n="7" goal="Create story variations">
+Adapt the story for different contexts and lengths.
+
+Ask what channels or formats will use this story.
+
+Based on the response, create:
+
+1. **Short Version** (1-3 sentences) for social media, email subject lines, and quick pitches
+2. **Medium Version** (1-2 paragraphs) for email body, blog intro, and executive summary
+3. **Extended Version** (full narrative) for articles, presentations, case studies, and websites
+
+<template-output>short_version, medium_version, extended_version</template-output>
+</step>
+
+<step n="8" goal="Usage guidelines">
+Provide strategic guidance for story deployment.
+
+Ask where and how the story will be used.
+
+Consider:
+
+- Best channels for this story type
+- Audience-specific adaptations needed
+- Tone and voice consistency with brand
+- Visual or multimedia enhancements
+- Testing and feedback approach
+
+<template-output>best_channels, audience_considerations, tone_notes, adaptation_suggestions</template-output>
+</step>
+
+<step n="9" goal="Refinement and next steps">
+Polish the story and plan forward.
+
+Ask:
+
+- What parts of the story feel strongest?
+- What areas could use more refinement?
+- What's the key resolution or call to action for your story?
+- Do you need additional story versions for other audiences or purposes?
+- How will you test this story with your audience?
+
+<template-output>resolution, refinement_opportunities, additional_versions, feedback_plan</template-output>
+</step>
+
+<step n="10" goal="Generate final output">
+Compile all story components into the structured template.
+
+Before finishing:
+
+1. Ensure all story versions are complete and polished.
+2. Format according to the template structure.
+3. Include all strategic guidance and usage notes.
+4. Verify tone and voice consistency.
+5. Fill all template placeholders with actual content.
+
+Write the final story document to `{default_output_file}`.
+
+Confirm completion with: "Story complete, {user_name}! Your narrative has been saved to {default_output_file}".
+
+<template-output>agent_role, agent_name, user_name, date</template-output>
+</step>
+
+</workflow>