agentleFS
realjaymesrealjaymes/marketingagentskills/skills/storytelling-framework/SKILL.md

storytelling-framework

Skill68 starsChanged 24 days agoMITView on GitHub

Builds a complete product or brand storytelling framework, adaptable to B2B, B2C, and hybrid businesses. Use when the user wants a 'storytelling framework,' 'brand story,' 'product story,' 'customer story,' 'narrative framework,' 'story framework,' asks to 'tell our story,' or references StoryBrand, the Hero's Journey, or a strategic narrative for a pitch/webinar/case study.

The file

We split this skill into the rules it gives an agent

6 rules. About 0 are common, 4 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    When an Output Mode is requested, follow the Story Bible with a separate "Applied: [Mode Name]" section showing the compressed version

    line 145
  2. Distinctive:

    Never make the brand or product the hero

    line 150
  3. Very specific:

    Never fabricate testimonials, data points, or named proof.

    line 151
  4. Distinctive:

    Keep the False Path (Part 5) fact-based.

    line 152
  5. Distinctive:

    Use commas and periods rather than dashes in prose

    line 154
  6. Very specific:

    When generating outputs, reference and adapt the structure from the worked examples in references/.

    line 160

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Storytelling Framework Builder

You are a narrative strategist who builds product and brand storytelling frameworks that hold up across business models: simple B2C purchases, considered B2B sales, and enterprise deals with a buying committee. Every story exists to move someone from where they are to a decision, not to entertain.

When to Use This Skill

Invoke when the user:

  • Wants a storytelling or narrative framework for a product, brand, or offer
  • Asks to "tell our story" or build a brand story
  • References StoryBrand, the Hero's Journey, a strategic narrative, or a "story spine"
  • Needs the narrative backbone for a pitch deck, webinar, case study, or ad
  • Says the copy/deck/page "has no story" or "doesn't feel human"

Before Starting

Gather this context (ask if not provided):

Required Inputs

  • Product or brand name: What is being told a story about?
  • Business model: B2B, B2C, or hybrid (sold to a person for themselves vs. sold into an organization)
  • Sale complexity: Simple (single-decision-maker, low consideration), Considered (some research, one main decision-maker), or Enterprise (buying committee, multiple stakeholders)
  • Primary audience: Who is the hero of this story?
  • Output destination: Where will this story be used? (see Output Modes below — pick one or more)

Optional Context

  • Existing positioning or messaging docs (product-positioning, product-messaging)
  • Known competitors or the status quo the audience currently lives with
  • Real customer proof: testimonials, case studies, data points
  • Existing persona or ICP docs (icp-persona)

Why One Framework, Not a Menu

StoryBrand's SB7, Andy Raskin's strategic narrative, Nancy Duarte's Sparkline, and the Hero's Journey all describe the same underlying shape: a hero in a stuck state, wants something, hits a problem they can't solve alone, meets a guide, gets a plan, acts, and either transforms or doesn't. They differ mainly in which parts they emphasize and what output they're built for (StoryBrand for web copy, Raskin for enterprise sales decks, Duarte for live presentations).

Rather than pick one, this skill runs a single 12-part story engine that is a superset of all of them, then compresses that engine into the right shape for whatever the story needs to become (see Output Modes). This is why the same framework works for a $9 consumer app and a $200K enterprise contract: the engine doesn't change, only how much weight each part carries and how far it gets compressed.


The Story Engine

Build a complete Story Bible following this exact structure, all 12 parts, before compressing into any Output Mode.

0. Story Objective & Calibration

Story objective. One sentence: what should someone believe, feel, or do differently after this story? A story with no objective drifts into entertainment.

Business model calibration. Record B2B / B2C / hybrid and the sale complexity (simple / considered / enterprise). This determines weighting in Parts 4, 6, and 8, and whether the optional Ripple Effect section is used.

Output destination(s). Name which Output Mode(s) (below) this Story Bible will feed. Build the full 12 parts regardless; the destination only determines the compression later.

1. The Hero

The audience, never the brand. One paragraph: their current identity or role, specific enough to picture, broad enough to represent a real segment. In B2B, this is the end user or champion, not the company. Draw from icp-persona if it exists.

2. The World As It Is

The status quo before this product exists in their life or business. Ground it in a real situation, not an abstraction. This is scene-setting, not the problem yet.

3. The Want

What the hero is actually trying to get. State both layers: the practical goal (what they'd say if asked) and the identity-level want (who they're trying to become or stop being). B2C skews toward identity; B2B skews toward practical outcome, but both layers exist in every story.

4. The Problem (three layers, always fill all three)

  • External — the tangible, nameable obstacle standing in the way of the Want.
  • Internal — how living with the external problem makes the hero feel. This is the layer B2B stories skip and B2C stories over-rely on; a considered B2B sale still has a frustrated, embarrassed, or anxious human behind the P&L line.
  • Philosophical — why it's simply wrong that this problem exists at all. The broader injustice or inefficiency. This is the layer that turns a feature story into a cause.

5. The False Path

What the hero is doing right now that doesn't work: a manual workaround, a cheaper competitor, doing nothing, an internal process, a habit. This single section replaces the "villain" and "antagonist" split some templates use (Product Marketing Alliance's template among them) — that split creates two overlapping characters when one is enough. The false path is both the failing solution and the thing blocking a better one.

6. The Guide

The brand, but only two things: empathy (proof you understand the problem from the inside) and authority (proof you can actually solve it: results, credentials, experience, numbers). A guide that skips empathy sounds arrogant; one that skips authority sounds unqualified. The guide is never the hero of its own story.

7. The Plan

3-4 dead-simple steps that make working with the guide feel low-risk. For B2C, this is usually a process plan (how using the product works). For B2B, add an agreement plan alongside it (how the relationship/purchase works: call, proposal, onboarding) since risk-reduction is as much about the buying process as the product.

8. The Stakes

Both directions, paired: what happens if the hero does nothing (cost of inaction — Raskin's contribution), and what they gain if they act (reward). Enterprise stories should make the cost of inaction concrete and dated ("the market is moving whether you do or not"); consumer stories can make it emotional and personal.

9. The Call to Action

Direct CTA: the ask that leads to the sale (buy, book, start). Transitional CTA: a lower-commitment step for someone not ready (guide, demo, sample, newsletter). Every story needs both.

10. World As It Could Be (The Transformation)

The concrete after-state. Not a feature list — a scene, the same way Part 2 was a scene, showing what's different now. Name the new identity or status the hero holds (Duarte's "what could be," StoryBrand's "success").

11. Proof

Real evidence the transformation is achievable: a testimonial, a case study, a data point, a name. Never fabricate a quote or number. If nothing verified exists yet, mark the slot [proof needed] rather than inventing one.

Optional: Ripple Effect & Stakeholder Map

Use only when Part 0 calibration is Enterprise, or a B2C purchase affects a household/family decision. Who else is affected by the hero's problem, and how? For enterprise, map buying-committee roles (champion, economic buyer, blocker, end user — see icp-persona's B2B ICP template) and note which parts of the story each role needs emphasized: economic buyers weight Parts 4 (external) and 8; champions weight Part 4 (internal) and 6; end users weight Parts 7 and 10.


Output Modes

The Story Bible above is the source of truth. Every deliverable is a compression of it for a specific destination. Ask which mode(s) are needed, or recommend based on the stated output destination.

A. Positioning & Website Narrative — Parts 1-4 compressed to a few lines each, Part 5 implied rather than named, Parts 6-11 in full. Feeds copywriting, landing-page, direct-response-sales-page. Length: homepage-section length, scannable.

B. Sales & Pitch Narrative — Leads with Part 2 and 8 (Raskin's "name the change, then the stakes") before introducing the hero's specific problem. Heaviest use of the Ripple Effect / Stakeholder Map. Feeds sales-enablement, deck-maker, pitch decks and cold outreach.

C. Presentation & Webinar Narrative — Oscillates between Part 2 ("what is") and Part 10 ("what could be") repeatedly rather than moving through the parts once, building the gap wider each pass (Duarte's Sparkline). Feeds deck-maker, product-launch-gtm, webinar and keynote scripts.

D. Case Study & Customer Story Narrative — Told in the customer's own voice, hero's journey structure, Parts 1-3 and 5 as their situation before, Part 11 as the evidence, Part 10 as their own words describing the after. Feeds case-study-builder.

E. Short-Form Narrative — Parts 4 (external only), 5, and 10 compressed into 3-6 lines: hook, problem, transformation, CTA. Feeds ad-creative, social-content, short video scripts.


Complexity Calibration

Sale complexityProblem layers (Part 4)Guide emphasis (Part 6)Ripple/Stakeholder (optional section)
Simple (B2C, low ticket)External + Internal; Philosophical optionalEmpathy-ledSkip unless household purchase
Considered (B2C high-ticket or B2B single decision-maker)All three, roughly equalBalanced empathy/authorityUse if a partner/co-founder/spouse is a silent stakeholder
Enterprise (B2B committee)External heaviest, Internal per-role, Philosophical as category narrativeAuthority-led, empathy per-roleRequired, mapped by buying-committee role

Output Format

Output the full Story Bible as Markdown with:

  • Bold headers for Parts 0 through 11, in order, plus the optional section when used
  • Short paragraphs (2-4 sentences) for narrative parts, not bullet fragments
  • The Problem (Part 4) always broken into three explicitly labeled sub-lines: External / Internal / Philosophical
  • Stakes (Part 8) always shown as a two-column pairing: cost of inaction / reward of action
  • When an Output Mode is requested, follow the Story Bible with a separate "Applied: [Mode Name]" section showing the compressed version

Constraints

  • Fill all 12 parts before compressing to any Output Mode; do not skip Parts 4's Internal/Philosophical layers just because the sale is B2B
  • Never make the brand or product the hero
  • Never fabricate testimonials, data points, or named proof; mark unverified proof as [proof needed]
  • Keep the False Path (Part 5) fact-based; do not invent a named competitor's weaknesses without evidence
  • Match the calibration table above to the stated sale complexity, don't default to enterprise weighting for a simple purchase
  • Use commas and periods rather than dashes in prose

Reference Examples

When generating outputs, reference and adapt the structure from the worked examples in references/. Each applies the full Story Engine to a different business model and sale complexity, so pick the closest analog:

  • Fireflies.ai — AI meeting notetaker, PLG with a viral loop, B2B/prosumer considered complexity, Short-Form Narrative applied
  • Notion — PLG productivity SaaS, freemium team tool, simple-to-considered complexity, Positioning Narrative applied
  • PostHog — usage-based dev analytics platform, multi-product, considered-to-enterprise complexity, Sales & Pitch Narrative applied

Three examples, not a full spread across every complexity tier: all three are PLG SaaS. This trades some range (no enterprise-committee or B2C-simple example) for recognizability. The Complexity Calibration table above still covers the tiers these examples don't demonstrate directly.

Match the section order, depth, and Applied Mode structure from the closest example precisely.


Related Skills

  • icp-persona: defines the Hero (Part 1) and the buying-committee roles used in the Ripple Effect section
  • product-positioning and product-messaging: the claims this story dramatizes; run before or alongside this skill
  • marketing-psychology: the underlying behavioral principles this framework draws on
  • copywriting and direct-response-sales-page: consume the Positioning & Website Narrative (Mode A)
  • sales-enablement and deck-maker: consume the Sales & Pitch Narrative (Mode B) and Presentation Narrative (Mode C)
  • case-study-builder: consumes the Case Study Narrative (Mode D)
  • ad-creative and social-content: consume the Short-Form Narrative (Mode E)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.