AGENT SKILL

archetypes-storytelling-arcs

Use this skill when designing narrative content — landing pages, case studies, onboarding flows, marketing campaigns, sales decks, ad arcs. Trigger when picking how to frame a customer story, when writing a launch campaign, or when the user mentions "this campaign feels flat" or "we need a better narrative." Sub-aspect of `archetypes`; read that first.

License 许可
Apache-2.0
最近更新
2026-11-14
Stars
★ 1.6k
Forks
491

01 前言 Front Matter

name
archetypes-storytelling-arcs
description
Use this skill when designing narrative content — landing pages, case studies, onboarding flows, marketing campaigns, sales decks, ad arcs. Trigger when picking how to frame a customer story, when writing a launch campaign, or when the user mentions "this campaign feels flat" or "we need a better narrative." Sub-aspect of `archetypes`; read that first.

02 资源文件 1

03 SKILL.md 正文

Storytelling arcs and the hero's journey

Stories are the most efficient way to convey emotional truth. A list of features is forgotten; a story of a user transformed by a product is remembered. Archetypes structure stories — the hero's journey is the most-cited template — and using them deliberately makes marketing, onboarding, and case studies dramatically more effective.

The hero's journey (Campbell, 1949)

Joseph Campbell distilled cross-cultural mythology into a single recurring pattern. The full version has 17 stages; the simplified product-narrative version has roughly 8:

  1. Ordinary world — the user's status quo (their pain, their constraint).
  2. Call to adventure — the product is introduced.
  3. Hesitation — the natural skepticism, the reasons not to.
  4. Mentor — the product (or its team) offers guidance.
  5. Crossing the threshold — first use, signing up.
  6. Trials — the work of using the product.
  7. Reward — the outcome, the transformation.
  8. Return / sharing — the user becomes an advocate.

This arc structures most successful marketing campaigns, customer case studies, and product launches.

Applying to product narratives

Customer case studies

A typical case study before applying the arc:

"Acme Corp uses our product. They report 40% productivity improvement."

Same case study with the arc:

"Acme Corp's marketing team was spending 4 days a week on reports — too much manual work, too little strategy. They tried our product as an experiment. After two weeks of integration, they automated 70% of their reporting workflow. Today, the team spends those reclaimed days on campaigns that have driven a 30% increase in qualified leads."

The arc gives the data emotional shape: pain → adventure → mentor → trials → reward.

Onboarding flows

Onboarding can follow the arc:

  • Welcome screen acknowledges the pain (ordinary world).
  • Setup is the call (adventure).
  • Tutorial is the mentor.
  • First successful task is the threshold-crossing.
  • Building momentum is the trials.
  • Achievement screen is the reward.
  • "Invite teammates" is the return / sharing.

Landing pages

Landing pages often follow a compressed arc:

  • Hero section: the call.
  • Problem section: the ordinary world.
  • Solution section: the mentor (your product).
  • Social proof: testimonials of others who completed the journey.
  • CTA: cross the threshold.

Marketing campaigns

A multi-touch campaign can play out across emails, ads, and content over weeks:

  • Week 1: name the problem (ordinary world).
  • Week 2: introduce the solution (call).
  • Week 3: address objections (hesitation).
  • Week 4: demo / trial (mentor + threshold).
  • Week 5: success stories (reward).

Picking the user's role

In product narratives, who is the hero? Three typical positionings:

The user is the hero; the product is the mentor

The user's transformation is the story; the product enables it. Most user-facing marketing positions this way. The user sees themselves in the story; the product is the magical artifact.

The product is the hero

Less common in modern marketing; more common in early advertising. The product itself is presented as the protagonist conquering the user's problem. Can feel inflated in modern contexts.

A different character is the hero

Case studies often position a specific named customer as the hero. Their transformation is the story.

The user-as-hero positioning is generally most effective because it lets the prospect insert themselves into the story.

Other arc patterns

The hero's journey isn't the only arc:

  • Three-act structure (setup, confrontation, resolution) — used in films, drama, and many product demos.
  • Problem-Agitation-Solution (PAS) — common in copywriting.
  • Before-After-Bridge (BAB) — present current state, desired state, the path between.
  • Story Brand framework (Donald Miller) — a 7-part framework derived from Campbell's work, applied to brand messaging.

Each is a structured way to give content emotional shape.

Anti-patterns

  • All features, no narrative. Bullet lists of features without the story of what they enable.
  • Inflated narrative. Treating routine product use as a hero's journey produces hyperbolic copy that erodes credibility.
  • No transformation. Stories that don't show change ("Customer uses our product. End.") fail to engage.
  • Hero confusion. Who is the protagonist? If unclear, the story flattens.
  • Skipping the trials. Stories that go directly from problem to triumph feel unrealistic; users know real adoption involves friction.

Heuristics

  1. The "what's the transformation?" check. Every effective narrative has a before/after. If your story has no transformation, it's not yet a story.
  2. The hero clarity test. Read your narrative. Who is the protagonist? If you can't tell in 3 seconds, fix.
  3. The trial honesty. Skipping over the work makes the story unbelievable. Brief acknowledgment of the friction makes the triumph credible.

Related sub-skills

  • archetypes (parent).
  • archetypes-brand-voice — voice consistency reinforces narrative.
  • storytelling (cognition) — narrative as memory aid.
  • framing (cognition) — how the story is framed affects user judgment.

04 同仓库更多 Skills

hashgraph-online
hashgraph-online/awesome-codex-plugins

migrate-to-e2e

Moves an existing Playwright, Cypress, Selenium, Appium, Detox, Maestro, or TesterArmy suite to e2e one slice at a time, with the old suite running beside the new one until each ported test is proven. Keeps a MIGRATION.md progress file so any later session resumes where the last stopped. Optionally plants a defect to show both suites catch it. Use for /migrate-to-e2e, "migrate our tests to e2e", "port these Maestro flows", "move our TesterArmy tests", or when a project has an e2e config and an older suite still running.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

e2e

Writes, runs, and debugs end-to-end tests for web and mobile apps with e2e, the agentic test runner, which mixes agent.act goals with exact locator assertions on a Playwright browser or an iOS or Android device. Also drives a project's running app live over the e2e MCP server to look at a screen, check a UI change, take a screenshot or record a video, and try a locator; and runs bug bashes, parallel e2e explore runs with each bug proven by a repro test. Use when a project depends on e2e or has an e2e.config.ts, when asked for end-to-end, browser, mobile, or agentic UI tests, to check a change in the running app, to QA or bug bash an app or branch, or when an e2e run fails.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

create-verification-skill

Generate a project-local verify-<app> skill on top of e2e, so any coding agent can launch the app, check it is worth driving, exercise a feature the way a user does, keep evidence, and bug bash it. Writes the skill, a feature map with one explore charter per feature, and proves it once. Use for /create-verification-skill, "make a verification skill for this repo", or when a project has no scripted way to prove UI behavior.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

deja-search

deja-vu memory — search the user's past AI coding sessions with the deja CLI. Holds what they already settled and never wrote into the repo (naming rules, banned or already-tried tools, required checks before merge, preferred values, who owns what). Use before your first edit in a task, before you call a change done or ready to merge, before you recommend a tool, library, design or reviewer, before re-debugging an error that may already be solved, when they say 'didn't we fix this before', 'what did we decide about X' or 'I already have that', and before telling them something on this machine does not exist.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

deja-reflect

End-of-session reflection and memory curation with deja-vu. Review what was decided, what commands broke and what repaired them, and record durable project rules or decisions with deja remember so the next session starts with them.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

revid

Make, edit, export and post AI videos with Revid (revid.ai) through the Revid MCP server. Use whenever the user wants a short-form or long-form video made (from an idea, a script, a URL, an article, a PDF, a tweet, a product page, their own clips, or a song), wants to find what is going viral on TikTok, YouTube, Instagram or X before making something, wants to edit or re-export an existing Revid project, generate a standalone AI image or clip, make a series episode, or publish and schedule a finished video to connected social accounts. Covers setup (hosted MCP with OAuth, or an API key), the 36 tools, credits, polling and the rules for publishing. Routes to the more specific revid-* skills when one fits.

图像与多媒体Skill与智能体开发
★ 1.6k