Communitygithub.com

FerroxLabs/murage

当用户拥有模块地图或章节列表,但问题是“这读起来怎么样”时,加载此技能。每当你听到“主线是什么”“章节应该如何流动”“感觉脱节”或“我有素材但还不是一本书”时,即可加载。

murage 是什么?

Murage 技能专为 AI 代理(如 Claude Code、Cursor 等)设计,用于指导长篇叙事(如课程、书籍或框架)的结构化构建。它强调所有内容必须围绕一个单一、清晰的主线论点组织,而非简单罗列主题。技能提供了四步标准化流程:1) 将主线提炼为一个句子;2) 选择三种默认叙事弧线之一(问题到解决、问题到答案、有风险的旅程);3) 根据张力而非主题对章节排序;4) 以最强场景开头,以重新承诺结尾。此外,它还包含明确的决策规则(如每资产一条主线)和反模式列表(如全面的前置内容、每个章节独立成岛、整体总结章节)。通过“修改前/修改后”的对比示例,Murage 帮助用户将零散的素材转化为连贯、引人入胜的长篇内容,确保读者或学习者保持兴趣并实现行为改变。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/FerroxLabs/murage/tree/HEAD/skills-library/spark-long-form-narrative

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

长篇叙事

何时加载此模式

用户拥有模块地图或章节列表,但现在的问题是“这读起来怎么样”。每当你听到“主线是什么”“章节应该如何流动”“感觉脱节”或“我有素材但还不是一本书”时,即可加载。

操作步骤

一门课程或一本书并不是一堆课程的列表。它是在多个章节中展开的一个论点。没有主线,学习者会得到一个文件夹里的文件,然后就不再打开它们。共四步。

1. 用单个论点陈述主线。 一句话:“本书主张 [论点],因为 [理由],读者现在应该 [行动]。”一条关于“自由职业者应该专注细分领域”的主线,比“这是我关于自由职业者的一切知识”更紧凑。每一章都必须推进主线。如果不行,那就是放错了抽屉的博客文章。

对于课程,主线就是论点形式的转化陈述。

2. 选择叙事弧线形状。 三种默认形状适用于大多数长篇作品:

  • 问题到解决。 从学习者当前的痛点开始。每一章移除一个障碍。以新状态结束。适用于以转化为导向的课程和操作指南类书籍。
  • 问题到答案。 从一个读者已经在问的问题开始。每一章使其更尖锐。以不同于预期的答案结束。适用于以理念为导向的书籍和框架。
  • 有风险的旅程。 从一个案例内部开始。每一章推进案例并提炼一个原则。以案例解决和原则命名结束。适用于叙事非虚构作品。

选择一种。混合形状会模糊主线。子情节没问题;但每份资产只有一个叙事弧线形状。

3. 根据张力而非主题对章节排序。 每一章回答前一章提出的问题,并引出下一个问题。一劳永逸地解决一切的章节会杀死吸引力;什么都不解决的章节会让人沮丧。模式:打开一个循环,关闭它的一部分,再打开一个更大的循环。

测试:在每一章的结尾,写一句话——“读者现在想知道什么,是在这一章之前他们不知道的?”如果不能,则裁剪、重新排序或重写结尾。

对于课程,在模块边界执行相同测试。模块二的结尾应该让模块三显得必不可少。

4. 以最强的场景开头;以重新承诺结尾。 第一行和第一页:从一个读者能识别的时刻开始,而不是定义。定义放在第二章。

最后一页:不要以总结结尾。以读者现在有能力做的一件事结尾,再加上一句允许从小处开始的话。“感谢阅读”无法引发行为改变。

对于课程,最后一课是重新承诺的时刻——一个最终的成果,明确告诉学员明天做什么。模糊的结尾会导致课程被束之高阁。

决策规则

  • 每份资产一条主线。 如果你不能用一句话写出来,那么这份资产里有两本书。要么拆分,要么选择一条。
  • 每一章必须凭其对抗主线证明存在的价值。 有趣但不沿主线的内容放入附录或删除。
  • 章节长度跟随张力,而非对称。 一篇 3,000 字的章节旁边是 8,000 字的章节也是可以的,只要两者都闭环。
  • 第一章是契约;最后一章是交接。 第一章以读者自己的语言承诺转变。最后一章用命名的最小下一步送读者上路。
  • 每本书一个框架。 两个命名的框架会相互竞争;读者一个也记不住。子模型嵌套在一个父模型之下。

反模式

  • 全面的前置内容。 冗长的领域历史,第一个场景之前有三个定义。论点还没开始读者就离开了。
  • 每个章节都是孤岛。 自包含、没有回调或向前牵引。读起来像杂志——可搜索但不可读。
  • 总结一切的章节。 重述整本书。如果主线成立,读者已经掌握了。
  • 以宣言结尾。 读起来令人激动,但星期一早上却毫无行动。命名下一个具体行动。
  • 在赢得信任之前宣布框架。 在读者感受到问题之前就在第一章命名模型。读者礼貌地点头并忘掉。

修改前 / 修改后

修改前: “第一章:什么是咨询。第二章:咨询行业。第三章:如何选择细分领域。第四章:如何找到客户……”

修改后: “主线:通才顾问的收入低于技能更差的专家,因为定价跟随定位,读者应在周五之前重写他们的标题。叙事弧线:问题到解决。第1章:一个通才输给了一个更差的专家。第2章:定位在买家感知中胜过技能。第3章:读者已经身处但尚未命名的细分领域。第4章:编写标题。第5章:新定位的前三条消息。结尾:读者重写标题并在合上书之前发送一条消息。”

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

FerroxLabs/murage

Web animation expertise covering CSS animations and transitions, Web Animations API, Framer Motion, GSAP, scroll-driven animations, layout animations, spring physics, reduce-motion preferences, and performance budgets. Use when the user asks about animation designer, animation designer best practices, or needs guidance on animation designer implementation. Do NOT use when the user needs a different specialized skill or is asking about an unrelated technology domain.

FerroxLabs/murage

Writes board-level narrative updates that complement financial reports with strategic context, competitive positioning, key risks, and forward-looking guidance for board of directors audiences. Use when the user needs to write a board update, board meeting narrative, or director-level briefing. Do NOT use for stakeholder updates to management (use `stakeholder-update`), investor emails (use `investor-update-email`), or full business reports (use `business-report`).

FerroxLabs/murage

>- End-to-end workflow for building a professional photography portfolio from niche selection through shooting, editing, website creation, and client acquisition. Covers gear decisions, shooting technique, post-processing workflow, portfolio curation, online presence, and the transition from hobbyist to working photographer. Use when the user wants to build photography portfolio or needs a structured multi-step process for this goal. Do NOT use when the request is a single-step task or requires professional advice beyond educational guidance.

FerroxLabs/murage

>- End-to-end workflow for creating a high-converting SaaS landing page from copywriting through design, development, SEO optimization, and analytics setup. Covers persuasion frameworks, responsive design, performance optimization, and conversion tracking to turn visitors into customers. Use when the user wants to build saas landing page or needs a structured multi-step process for this goal. Do NOT use when the request is a single-step task or requires professional advice beyond educational guidance.

FerroxLabs/murage

Calculates startup burn rate (gross and net), projects cash runway in months, and builds scenario analysis for different spending and revenue trajectories. Use when the user asks about burn rate, cash runway, how long their money will last, or startup cash management. Do NOT use for personal savings calculations (use budget-planning), full financial modeling (use financial-model-structure), or fundraising narrative (use fundraising-narrative).

FerroxLabs/murage

The user is asking \"how long do we have,\" \"can we afford this hire,\" or \"are we running out.\" Load whenever cash, burn, or time-to-zero shows up — or when a spending decision is on the table and the user doesn't know how many months it costs.

FerroxLabs/murage

Professional corporate video production guidance covering training videos, promotional content, testimonials, and product demos. Includes client brief templates, script approval workflows, achieving professional quality on budget, brand compliance, stakeholder management, and delivery specifications. Use when the user asks about corporate video or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

FerroxLabs/murage

Helps artists, designers, and creative professionals curate, organize, and present their work through compelling portfolios across digital platforms, personal websites, and print formats for career advancement. Use when the user asks about creative portfolio builder, related techniques, best practices, or needs guidance in this domain. Do NOT use when the request is outside the scope of creative portfolio builder or requires a different specialized skill.

FerroxLabs/murage

Cross-discipline creative portfolio assessment evaluating artistic cohesion, technical skill, presentation quality, and market positioning. Produces a scored evaluation with recommendations for strengthening creative identity and professional opportunity. Use when the user asks about creative portfolio evaluator, related techniques, best practices, or needs guidance in this domain. Do NOT use when the request is outside the scope of creative portfolio evaluator or requires a different specialized skill.

FerroxLabs/murage

Professional design portfolio evaluation assessing design process, craft quality, range of work, presentation, and industry alignment. Produces a scored review with recommendations for strengthening design practice and career positioning. Use when the user asks about design portfolio reviewer, related techniques, best practices, or needs guidance in this domain. Do NOT use when the request is outside the scope of design portfolio reviewer or requires a different specialized skill.

FerroxLabs/murage

Teaches specific named emotional regulation techniques (the STOP technique, urge surfing, cognitive reframing, emotional labeling, opposite action, and physiological soothing) with step-by-step sequences. Gathers the user's emotional challenges and triggers, then produces a personalized regulation toolkit with technique instructions and a situation-response plan. Use when the user asks about managing emotions, controlling anger, handling frustration, emotional regulation strategies, or building emotional resilience. Do NOT use for clinical emotional dysregulation treatment, personality disorder management, or replacing professional mental health support.

FerroxLabs/murage

Structures a fundraising narrative for startup investors covering traction, market size, business model, use of funds, and milestone targets using standard VC pitch structure. Use when the user asks about fundraising pitch, investor narrative, raising capital, pitch deck story, or investment memo. Do NOT use for sales pitch decks (use sales-pitch-deck), personal loan applications, grant proposals (use grant-proposal-writing), or financial model creation (use financial-model-structure).

FerroxLabs/murage

Interactive storytelling for games covering branching narratives, dialogue trees, environmental storytelling, lore design, character writing for games, quest design, player agency, world-building for interactive media, and narrative integration with game mechanics. Use when the user asks about game narrative writer or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

FerroxLabs/murage

Writes Instagram captions with a hook line, story body, hashtag strategy, and platform-optimized call-to-action. Use when the user wants to write an Instagram caption, create Instagram content, or draft text to accompany an Instagram post or reel. Do NOT use for LinkedIn posts (use `linkedin-post`), Twitter threads (use `twitter-thread`), or blog posts (use `blog-post-writing`).

FerroxLabs/murage

Produces conversion-optimized landing page copy with hero section, problem statement, solution, social proof, and CTA sections using conversion copywriting methodology. Use when the user asks to write landing page copy, create a product page, write a sales page, draft conversion copy, or write landing page text for a website. Also useful when asked to write website copy or create a page that converts visitors. Do NOT use for ad copy (use paid-ad-copy), product descriptions for e-commerce listings (use product-description), or full website content strategy (use seo-content-strategy).

FerroxLabs/murage

Guides the user through launching a professional art or creative portfolio from curation through outreach, chaining 5 atomic skills across career-development, design-creative, and writing categories. Covers physical vs. digital portfolio, platform selection, fine art vs. commercial positioning, and curated vs. comprehensive approaches. Use when the user wants to create and launch a portfolio to attract clients, galleries, or employers. Do NOT use for building a job search portfolio in non-creative fields (use land-new-job workflow), personal brand content strategy (use build-personal-brand workflow), or creating the artwork itself.

FerroxLabs/murage

>- Complete YouTube channel launch workflow from niche selection and channel strategy through video production, editing, monetization setup, community building, and personal brand development for sustainable channel growth. Use when the user wants to launch youtube channel or needs a structured multi-step process for this goal. Do NOT use when the request is a single-step task or requires professional advice beyond educational guidance.

FerroxLabs/murage

Run a section-by-section conversion teardown of one landing page — hero, value proposition, social proof, features, objection handling, CTA and footer — plus form, mobile and page-speed audits, ending in prioritised fixes split into quick wins, strategic and long-term, with A/B test hypotheses. Use when one page has traffic and is not converting. Do NOT use for a whole-site marketing audit (use market-audit), for the copy voice and awareness-stage decisions behind it (use copy-awareness-stages) or for the visual system it should sit inside (use mira-visual-system).

FerroxLabs/murage

Comprehensive motion graphics guidance covering title design, lower thirds, animated explainers, kinetic typography, logo animation, After Effects and Apple Motion workflows, design principles for motion, storyboarding for motion, and building a motion design practice. Use when the user asks about motion graphics or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

FerroxLabs/murage

Comprehensive animation guidance covering the 12 principles of animation, 2D and 3D production pipelines, tools (Blender, After Effects, Procreate, Toon Boom), frame rates, rigging, motion graphics vs character animation, and building an animation practice from concept to final render. Use when the user asks about animation creator or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

相关技能