Agent skill

Storytelling Advisor

by iflytek in iflytek/skillhub

Shape pitches, brand stories, presentations, and creative writing with narrative frameworks such as the Hero's Journey, Story Spine, and Freytag's Pyramid.

MITAuto-check passedWriting & Content

Install Storytelling Advisor

skills CLI
$ npx skills add iflytek/skillhub --skill storytelling-advisor -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install iflytek/skillhub storytelling-advisor --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/iflytek/skillhub.git skills-src && mkdir -p .claude/skills && cp -r skills-src/builtin-skills/skills/storytelling-advisor .claude/skills/storytelling-advisor && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
storytelling-advisor
GitHub stars
5.2k
Token cost
~2.3k tokens
SKILL.md length
1,186 words
Files
3
Skills in repo
29
Repo updated
First seen
Licence
MIT

At a glance

Shape pitches, brand stories, presentations, and creative writing with narrative frameworks such as the Hero's Journey, Story Spine, and Freytag's Pyramid.

  • Works in 12 steps: The Hero's Journey (Monomyth) → Pixar Storytelling Formula → Freytag's Pyramid (Dramatic Structure) → …
  • A user wants to structure
  • SKILL.md covers What It Does, Fact and Fiction Boundary, Frameworks Available and Trigger Phrases, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Storytelling Advisor is an agent skill from iflytek/skillhub. Shape pitches, brand stories, presentations, and creative writing with narrative frameworks such as the Hero's Journey, Story Spine, and Freytag's Pyramid. Use when a user wants to structure, critique, or strengthen a story.

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `NOTICE.md`).

It sits in Writing & Content, covering Storytelling and Creative writing and fiction. The repository describes itself as: Self-hosted, open-source agent skill registry for enterprises. Publish & version skill packages, govern with RBAC and audit logs, deploy on-premise with Docker or Kubernetes. The licence is MIT.

When your agent uses it

  • A user wants to structure
  • Strengthen a story

Example prompts

  • “s Journey, Story Spine, and Freytag”
  • “/storytelling-advisor”

Workflow steps

12 steps, taken from the step headings in SKILL.md.

  1. The Hero's Journey (Monomyth)
  2. Pixar Storytelling Formula
  3. Freytag's Pyramid (Dramatic Structure)
  4. The Story Spine
  5. The Inverted Pyramid
  6. Clarify the Goal
  7. Harvest the Raw Material
  8. Select the Framework
  9. Map Content to Structure
  10. Add Narrative Devices
  11. Refine and Cut
  12. End with a Punch

What it can do on your machine

Read from SKILL.md and the folder at commit 72429e6. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Storytelling Advisor loads about 2.3k tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 1,186 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~61
When it runs · the whole SKILL.md, loaded when a task matches
~2.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from iflytek/skillhub at commit 72429e6, republished under its MIT licence (© iflytek). 1,186 words, ~2,270 tokens.

Download SKILL.mdSave it as .claude/skills/storytelling-advisor/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
storytelling-advisor
description
Shape pitches, brand stories, presentations, and creative writing with narrative frameworks such as the Hero's Journey, Story Spine, and Freytag's Pyramid. Use when a user wants to structure, critique, or strengthen a story.
version
1.0.0
license
MIT

Storytelling Advisor

What It Does

Transforms raw ideas, experiences, or messages into structured narratives using proven storytelling frameworks. Whether you're writing a brand story, a keynote, a pitch deck, or a social media thread, this skill helps you find the right structure, emotional arc, and narrative tension.

Fact and Fiction Boundary

  • For case studies, pitches, testimonials, biographies, and other factual narratives, use only facts the user supplied or explicitly confirmed.
  • Never silently invent names, quotations, dates, durations, metrics, customers, outcomes, motives, or events to make a factual story more compelling.
  • Mark missing material as a question, a placeholder such as [customer outcome needed], or an explicitly labeled illustrative option.
  • Invent details only when the user requests fiction or explicitly authorizes creative fabrication. Keep fictional additions distinguishable from factual claims.

Frameworks Available

1. The Hero's Journey (Monomyth)

Best for: Brand origin stories, founder journeys, case studies, transformation narratives

StageDescriptionPrompting Question
Ordinary WorldThe hero's normal life before the adventureWhat was life like before the problem was solved?
Call to AdventureAn event disrupts the status quoWhat changed? What forced action?
Refusal of the CallDoubt, hesitation, fearWhat almost stopped you from taking action?
Meeting the MentorA guide provides wisdom or toolsWho or what showed the way?
Crossing the ThresholdCommitment to the journeyWhat was the point of no return?
Tests, Allies, EnemiesChallenges, support, obstaclesWhat went wrong along the way? Who helped?
Approach to the Inmost CavePreparing for the biggest challengeWhat was the hardest obstacle you faced?
OrdealThe central crisisWhat was make-or-break moment?
RewardThe prize for surviving the ordealWhat did you gain?
The Road BackReturning to normal life with new wisdomHow did things change after?
ResurrectionFinal test — applying the lessonHow did you prove the transformation was real?
Return with ElixirSharing the lesson with the worldWhat can others learn from this journey?
2. Pixar Storytelling Formula

Best for: Short-form narratives, social media stories, email sequences, product launches

Structure: Once upon a time there was ___. Every day, ___. One day ___. Because of that, ___. Because of that, ___. Until finally ___.

ElementRoleFictional product-story example
Once upon a time...Setup — who, where, when"Once upon a time, a community organizer struggled to coordinate neighborhood repairs."
Every day...Status quo — the routine struggle"Every day, useful items were discarded because neighbors could not find help."
One day...Inciting incident"One day, the organizer sketched a simple repair-matching service."
Because of that...Consequence 1"Because of that, volunteers could list the skills they offered."
Because of that...Consequence 2"Because of that, neighbors could match broken items with local help."
Until finally...Resolution"Until finally, the first fictional repair day could be coordinated in one place."
3. Freytag's Pyramid (Dramatic Structure)

Best for: Speeches, presentations, campaign narratives

ElementPurpose
ExpositionContext — what's the situation?
Rising ActionTension builds — what's at stake?
ClimaxThe turning point — the big reveal or decision
Falling ActionConsequences unfold
DenouementResolution and takeaway
4. The Story Spine

Best for: Team storytelling, collaborative narrative building

Once upon a time... And every day... But one day... And because of that... And because of that... And because of that... Until finally... And ever since that day... The moral of the story is...

5. The Inverted Pyramid

Best for: Newsletters, blog posts, executive summaries

LayerContent
LeadThe most critical information (who, what, when, where, why)
BodySupporting details, context, evidence
TailBackground, nuance, optional reading

Trigger Phrases

PhraseAction
"Help me tell a story about..."Guides you through selecting the best framework
"Turn this into a narrative..."Structures raw info into a story arc
"Make this more compelling..."Suggests adding stakes, tension, or emotional beats
"Tell my brand story..."Applies Hero's Journey to brand/founder narrative
"Pixar this for me..."Forces content into the Pixar formula
"What framework should I use for..."Recommends the best framework for your context
"Pitch this as a story..."Converts a pitch into narrative form

Step-by-Step Instructions

Step 1: Clarify the Goal

Infer what the audience should feel, think, and do from the request. Ask one focused question only when the missing goal would materially change the story.

Show full SKILL.md (489 more words)Show less
Step 2: Harvest the Raw Material

Collect:

  • Characters (who is the hero? who is the mentor? who is the antagonist?)
  • Setting (where and when does this happen?)
  • Conflict (what was the problem or challenge?)
  • Stakes (what was at risk?)
  • Transformation (how did things change?)
  • Lesson (what can be learned?)

Separate confirmed facts from assumptions and gaps before drafting. Ask only for gaps that materially affect the story; otherwise retain visible placeholders.

Step 3: Select the Framework

Match the story type to the right structure:

If you're telling...Use...
A founder origin storyHero's Journey
A product value propPixar Formula
A keynote or speechFreytag's Pyramid
A social media threadStory Spine
A newsletter or articleInverted Pyramid
Step 4: Map Content to Structure

Fill each framework slot with your raw material. Identify gaps and missing beats.

Step 5: Add Narrative Devices
  • Emotional hook: Start with a relatable moment or surprise
  • Specific details: Prefer concrete details supplied by the user. Never add a detail such as "3 AM in a coffee shop" to a factual account unless it is confirmed.
  • Tension: What was almost lost? What was uncertain?
  • Pacing: Short sentences for action, longer ones for reflection
Step 6: Refine and Cut
  • Remove everything that doesn't serve the goal
  • Read aloud to test rhythm
  • Tighten: Can you say it in half the words?
Step 7: End with a Punch

The last line should be memorable — a lesson learned, a question posed, an invitation extended.


Examples

Example 1: Factual Founder Story with Gaps

Input: "I built a project management tool because Trello was too simple and Jira was too complex."

Output (outline):

  • Problem: Existing tools felt either too simple or too complex for the user's needs.
  • Action: The user built a project management tool.
  • Outcome: [What changed for you or your users?]
  • Evidence needed: [Who first used it?] [What measurable result can be verified?]

Do not add a company size, customer crisis, development timeline, adoption count, or testimonial unless the user supplies it.

Example 2: Explicitly Fictional Product Launch Exercise

Input: "Create a fictional launch-story example for a new habit tracking app."

Output: "Fictional example: Once upon a time, there was a developer who wanted a kinder way to build habits. Every day, rigid streaks made one missed day feel like failure. One day, the developer tried a tracker that welcomed restarts. Because of that, returning became easier. Until finally, the idea became an app designed around beginning again."


Pro Tips

  • Start in the middle: The most interesting story doesn't always start at the beginning. Open with the crisis, then flash back.
  • Use contrast: Before/after, then/now, almost lost/eventually won.
  • Use verified specificity: Real, sourced numbers are stronger than generic claims. Use placeholders when the number is not known.
  • Include a limitation: For factual stories, include a supported challenge or trade-off rather than making the subject unrealistically one-dimensional.
  • End with a call-to-story: Invite the audience to see themselves in the narrative.

© iflytek, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files in builtin-skills/skills/storytelling-advisor of iflytek/skillhub.

  • SKILL.md
  • LICENSE.txt
  • NOTICE.md

Open the folder on GitHubat commit 72429e6

Compare with similar skills

Storytelling Advisor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Storytelling Advisor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Storytelling Advisor this skilliflytek/skillhub5.2k—~2.3kAutomated safety check: PassMIT
Chinese Novel Writing Systemleenbj/novel-creator-skill671—~3.9kAutomated safety check: PassNone
Chinese Novelist Chapter WriterPenglongHuang/chinese-novelist-skill3.3k—~491Automated safety check: WarnMIT
Sun-Style Restrained Narrative WritingKKKKhazix/sun-style-writing403—~1.7kAutomated safety check: PassMIT
Long Story AnalysisNarcooo/inkos10k—~364Automated safety check: PassAGPL-3.0
Short Web Fiction Writeruu201/character-arc583—~3.7kAutomated safety check: PassMIT

Similar skills

  • Chinese Novel Writing System

    leenbj/novel-creator-skill

    Guides long-form Chinese novel writing from a rough idea through outlines, chapter drafts and quality gates, with file-based memory for a story meant to reach 300万字.

    671 GitHub stars~3.9k tokensUpdated 7 mo ago
    Writing & ContentAuto-check passed
  • Chinese Novelist Chapter Writer

    PenglongHuang/chinese-novelist-skill

    Writes long Chinese novels chapter by chapter through guided questions, outlining, drafting with cliffhangers and automatic validation, with resumable projects.

    3.3k GitHub stars~491 tokensUpdated 4 days ago
    Writing & ContentAuto-check: warnings
  • Sun-Style Restrained Narrative Writing

    KKKKhazix/sun-style-writing

    Writes Chinese first-person nonfiction in a restrained plain-description style: short sentences, exact numbers, objects that carry feeling and silence at the peak.

    403 GitHub stars~1.7k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Long Story Analysis

    Narcooo/inkos

    Breaks down a full novel or long sample into story mechanisms and style traits the agent can reuse as craft, without copying names or wording.

    10k GitHub stars~364 tokensUpdated today
    Writing & ContentAuto-check passed
  • Short Web Fiction Writer

    uu201/character-arc

    Walks an agent through writing a complete short web novel in Chinese, starting from the emotion the reader should feel and building around one twist.

    583 GitHub stars~3.7k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Grades whether a downstream story beat still holds after an upstream insertion, returning a strict JSON verdict of still_valid, needs_rewrite or must_delete.

    181 GitHub stars~2.3k tokensUpdated 5 mo ago
    Writing & ContentAuto-check passed

More from iflytek/skillhub

All 29 skills in this repo
  • Orca Run Replay

    iflytek/skillhub

    Answers questions about a past agent run from its recording, using causal graphs and replay, instead of reconstructing events from memory.

    5.2k GitHub starsUsed in 4 repos~3k tokens
    Auto-check passed
  • Zero Slop Prose Editor

    iflytek/skillhub

    Audits and rewrites formulaic, AI-sounding prose while keeping facts, voice and format, using a local Python scorer and inspect-only, rewrite or embedded-gate modes.

    5.2k GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Sandbase

    iflytek/skillhub

    Access 2,000+ AI models and API tools through one MCP interface for inference, media generation, search, scraping, embeddings, social data, and structured retrieval.

    5.2k GitHub starsUsed in 2 repos~2.1k tokens
    Auto-check passed
  • LinkedIn Post Formatter

    iflytek/skillhub

    Drafts a copy-paste-ready LinkedIn post from your facts and ideas, choosing the smallest structure that fits and keeping an accessible plain-text fallback for any styled text.

    5.2k GitHub stars~901 tokensUpdated today
    Auto-check passed
  • SkillHub CLI

    iflytek/skillhub

    Connects an agent to a SkillHub registry and uses the official SkillHub CLI to search, install, list and explicitly upgrade skills from that registry.

    5.2k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • AI Claim Checker

    iflytek/skillhub

    Breaks AI-generated text into checkable claims, verifies them against independent sources and labels each one, with an optional exercise for learners.

    5.2k GitHub stars~1.2k tokensUpdated today
    Auto-check passed

Questions about Storytelling Advisor

What does Storytelling Advisor do?

Shape pitches, brand stories, presentations, and creative writing with narrative frameworks such as the Hero's Journey, Story Spine, and Freytag's Pyramid. Storytelling Advisor is an agent skill from iflytek/skillhub. Shape pitches, brand stories, presentations, and creative writing with narrative frameworks such as the Hero's Journey, Story Spine, and Freytag's Pyramid.

When should I use Storytelling Advisor?

Storytelling Advisor fits situations like: A user wants to structure; strengthen a story.

How do I install Storytelling Advisor in Claude Code?

Run `npx skills add iflytek/skillhub --skill storytelling-advisor -a claude-code`. Or copy the skill folder (builtin-skills/skills/storytelling-advisor in iflytek/skillhub) into .claude/skills/storytelling-advisor in your project. Claude Code loads it when a task matches its description.

How do I install Storytelling Advisor in Codex?

Run `npx skills add iflytek/skillhub --skill storytelling-advisor -a codex`. Or copy the skill folder (builtin-skills/skills/storytelling-advisor in iflytek/skillhub) into .agents/skills/storytelling-advisor in your project. Codex loads it when a task matches its description.

Can I use Storytelling Advisor in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add iflytek/skillhub --skill storytelling-advisor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/storytelling-advisor, .gemini/skills/storytelling-advisor, .github/skills/storytelling-advisor and .opencode/skills/storytelling-advisor in your project.

What does Storytelling Advisor need to run?

SKILL.md names no scripts, command-line tools or credentials: Storytelling Advisor is instructions for the agent only.

Does Storytelling Advisor access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Storytelling Advisor safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Storytelling Advisor use?

Storytelling Advisor is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Storytelling Advisor use?

About 2.3k tokens (SKILL.md is roughly 9.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Storytelling Advisor?

Skills that share tags, products or a category with Storytelling Advisor: Chinese Novel Writing System (leenbj/novel-creator-skill, 671 stars), Chinese Novelist Chapter Writer (PenglongHuang/chinese-novelist-skill, 3.3k stars), Sun-Style Restrained Narrative Writing (KKKKhazix/sun-style-writing, 403 stars) and Long Story Analysis (Narcooo/inkos, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Storytelling Advisor?

iflytek (a GitHub organization) maintains it in iflytek/skillhub, which has 5,165 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on October 10, 2026.

Source: iflytek/skillhub on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.