Skip to content

Commit 58d75be

Browse files
committed
feat: convert storytelling to native skill
1 parent 131768f commit 58d75be

12 files changed

Lines changed: 349 additions & 392 deletions

File tree

AGENTS.md

Lines changed: 5 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ src/
4141
│ ├── design-thinking/
4242
│ ├── innovation-strategy/
4343
│ ├── problem-solving/
44-
│ └── storytelling/
44+
│ └── bmad-cis-storytelling/
4545
├── teams/ # Multi-agent collaboration configs
4646
└── module.yaml # Module metadata and installation config
4747
```
@@ -58,17 +58,14 @@ Agents are defined in `*.agent.yaml` files with three core components:
5858
**Example agent trigger flow:**
5959
- User: `/cis-brainstorm` or just mentions "brainstorm"
6060
- Agent matches trigger → executes associated workflow
61-
- Workflow provides structured methodology via instructions.md
61+
- Workflow provides structured methodology via `workflow.md` or legacy `instructions.md`
6262
- Output generated using template.md
6363

6464
### Workflow Structure
6565

66-
Each workflow directory contains:
67-
- `workflow.yaml` - Configuration with path references (uses `{project-root}` and `{config_source}` placeholders)
68-
- `instructions.md` - Methodological guidance for the AI
69-
- `template.md` - Output format structure
70-
- `*.csv` - Framework data (story types, techniques, etc.)
71-
- `README.md` - Human-readable overview
66+
Workflows currently ship in two source formats:
67+
- Legacy workflows keep `workflow.yaml` plus `instructions.md`, along with `template.md` and any `*.csv` support files.
68+
- Native skill workflows keep `SKILL.md`, `workflow.md`, `bmad-skill-manifest.yaml`, and only the companion files the skill needs at runtime.
7269

7370
**Key workflow concepts:**
7471
- `standalone: true` - Workflows are self-contained

src/agents/storyteller/storyteller.agent.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,5 +21,5 @@ agent:
2121

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

src/module-help.csv

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,4 +3,4 @@ cis,anytime,Innovation Strategy,IS,,_bmad/cis/workflows/innovation-strategy/work
33
cis,anytime,Problem Solving,PS,,_bmad/cis/workflows/problem-solving/workflow.yaml,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",
44
cis,anytime,Design Thinking,DT,,_bmad/cis/workflows/design-thinking/workflow.yaml,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",
55
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",
6-
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",
6+
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

Lines changed: 14 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ Five interactive workflows facilitating creative and strategic processes through
5151

5252
**Output:** Root cause identification and solution strategies
5353

54-
### [Storytelling](./storytelling)
54+
### [Storytelling](./bmad-cis-storytelling)
5555

5656
**Purpose:** Craft compelling narratives
5757

@@ -108,14 +108,23 @@ Edit `/_bmad/cis/config.yaml`:
108108

109109
## Workflow Structure
110110

111-
Each workflow contains:
111+
Source workflows currently use two shapes during the native-skill transition:
112112

113-
```
114-
workflow-name/
113+
```text
114+
legacy-workflow/
115115
├── workflow.yaml # Configuration
116116
├── instructions.md # Facilitation guide
117117
├── techniques.csv # Method library
118-
└── README.md # Documentation
118+
└── README.md # Documentation
119+
```
120+
121+
```text
122+
bmad-cis-storytelling/
123+
├── SKILL.md
124+
├── workflow.md
125+
├── bmad-skill-manifest.yaml
126+
├── story-types.csv
127+
└── template.md
119128
```
120129

121130
## Best Practices
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
---
2+
name: bmad-cis-storytelling
3+
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"'
4+
---
5+
6+
Follow the instructions in [workflow.md](workflow.md).
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
type: skill
File renamed without changes.
File renamed without changes.

0 commit comments

Comments
 (0)