
resonance-engine
Use when writing is structurally clear but emotionally flat—adds turning points, sensory metaphors, and change hooks using Storr's brain-change model and Hopkins' specificity techniques.
- Installs
- 43
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/joellewis/skill-library --skill resonance-engine- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads resonance-engine automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Overview
Resonance is the intersection of neurological engagement and tactical persuasion. It moves beyond "clear writing" to "moving writing." By using the brain's natural bias for unexpected change (Storr), emotional turning points (McKee), and selfish benefits (Hopkins), the Resonance Engine transforms passive readers into active converts.
Guiding Principles
Principle 1: Unexpected Change as the Hook (Source: Storr, Science of Storytelling)
The brain is a "change-detecting machine." To grab attention, start with a moment of unexpected change or the opening of an information gap. Curiosity is a biological craving (the "Lowercase n" shape); provide enough information to tease the answer but not enough to solve the mystery immediately.
Principle 2: The Selfish Reader Rule (Source: Hopkins, Scientific Advertising)
The reader cares nothing for your profit or your brand; they seek service for themselves. Frame every claim around the benefit to "You." Instead of "Buy our brand," say "Here is how this saves you $500."
Principle 3: Discovery Over Persuasion (Source: Graham, "Persuade xor Discover")
Writing specifically to persuade often feels "salesy" and triggers skepticism. Writing to discover the truth is more influential. Conviction should come from the evidence itself, not from rhetorical tricks.
Principle 4: Specificity is Authority (Source: Hopkins, Scientific Advertising)
Platitudes like "best in the world" roll off the reader like water. Specific claims like "softens beards in 78 seconds" or "9% net profit" are accepted as truth because they imply rigorous testing and authority.
Principle 5: Sensory Metaphors (Source: Storr, Science of Storytelling)
Metaphors that evoke touch, weight, or movement (e.g., "shouldering the burden," "rough day") activate the same neural networks used for physical experience. This makes the writing "felt" rather than just "read."
When to Use This Skill
- Writing investor pitches or funding proposals.
- Creating high-impact marketing copy or "reason-why" advertising.
- Drafting speeches or emotional appeals.
- Refining a "controlling idea" or theme for a long-form document.
When NOT to Use This Skill
- Technical documentation where emotional resonance might distract from literal clarity.
- Neutral status updates or administrative logs.
Core Process
Step 1: The "Inciting Incident" Hook (Source: McKee, Story)
Identify the moment of change that triggers the piece.
- The Question: What just changed?
- The Gap: What mystery does the reader need to solve? Open the "Mystery Box" in the first paragraph.
Step 2: Polarity Reversal (Source: McKee, Story)
Review your narrative arc or argument. A resonant piece must have "turning points" where the emotional polarity shifts (e.g., from Doubt to Hope, or from Complacency to Urgency). If the tone is flat, the resonance is dead.
Step 3: The "Benefit Filter" (Source: Hopkins, Scientific Advertising)
Audit every claim. Convert "Features" (what it is) into "Outcomes" (what it does for them).
- Feature: "Our AI uses neural models."
- Outcome: "Our AI finds revenue leaks in 30 seconds."
Step 4: Sensory Audit (Source: Storr, Science of Storytelling)
Identify abstract adjectives (e.g., "terrible," "amazing") and replace them with specific sensory details. Use metaphors that hit the "motor system" of the brain. Instead of "a difficult task," use "a hill too steep to climb."
Step 5: Truth Discovery (Source: Graham, "Persuade xor Discover")
Remove "salesy" qualifiers and superlatives. Ensure the most persuasive point is a "truth" you discovered during the writing process rather than a talking point you started with.
Frameworks & Models
The "Lowercase n" Curiosity Curve (Source: Storr, Science of Storytelling)
- Low Curiosity: No knowledge or 100% certainty.
- Maximum Curiosity: Partial knowledge (The Zone of Resonance).
- Action: Provide the context (knowledge) but withhold the resolution (the answer).
Reason-Why Copy (Source: Hopkins, Scientific Advertising)
- The Headline: Filter for the target audience ("To men who want 9% profit").
- The Offer: A service or sample ("Try this for one week").
- The Proof: Specific, exact figures.
- The Action: A clear next step.
Cross-Skill Invocations
REQUIRED SUB-SKILL: copy-editor — to remove the "verbal false limbs" that kill resonance. RECOMMENDED SUB-SKILL: fiction-architect — for the narrative arc of a persuasive pitch.
Common Mistakes
- The Gloomy Side: Focusing on the dark side (prevention/pain) rather than the bright side (health/success). Positive framing outpulls negative 4 to 1. (Source: Hopkins)
- The "Worn-Out" Metaphor: Using clichés that have lost their sensory impact (e.g., "thinking outside the box"). (Source: Storr/Orwell)
- Naive Realism: Assuming your "truth" is obvious to everyone and treating skeptics as "idiots." (Source: Storr)
- Engagement Bait (The Degenerate Curiosity Gap): The "Lowercase n" curiosity curve is a legitimate tool — provide partial knowledge to pull the reader forward. Its corrupt form is false suspense: "But here's the thing," "Here's what most people get wrong," "The real question is…" These phrases promise a revelation and deliver a commonplace. They trigger the same skepticism Principle 3 warns about: the reader detects performance rather than discovery, and credibility collapses. If the information gap is real, the structure itself creates curiosity; you do not need to announce it. (Source: Graham / Storr)
Diagnostic Checklist
- Is there a moment of unexpected change in the lead?
- Have I replaced generalities with exact figures?
- Does the piece focus on the reader's benefit ("You")?
- Are there at least two sensory metaphors that activate physical models?
- Does the piece have an emotional turning point (polarity shift)?
Sources
- Storr, Will. The Science of Storytelling. Ch. 1 (Unexpected Change), Ch. 1.7 (Metaphor).
- McKee, Robert. Story. Ch. 8 (The Inciting Incident), Ch. 13 (Turning Points).
- Hopkins, Claude. Scientific Advertising. Ch. 2 (Just Salesmanship), Ch. 7 (Being Specific).
- Graham, Paul. "Persuade xor Discover".
FAQ
What does the resonance-engine skill do?
Use when writing is structurally clear but emotionally flat—adds turning points, sensory metaphors, and change hooks using Storr's brain-change model and Hopkins' specificity techniques.
How do I install resonance-engine?
Run npx skills add https://github.com/joellewis/skill-library --skill resonance-engine in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/resonance-engine/ (personal) or .claude/skills/resonance-engine/ (project).
Which AI agents can use resonance-engine?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is resonance-engine safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains resonance-engine?
It is published by joellewis in joellewis/skill-library. It has 43 recorded installs.
More from joellewis/skill-library
fiction-architect
joellewis/skill-library
Open the skill to read its SKILL.md instructions.
world-building-logic
joellewis/skill-library
Open the skill to read its SKILL.md instructions.
character-vulnerability
joellewis/skill-library
Open the skill to read its SKILL.md instructions.
problem-framing
joellewis/skill-library
Use when beginning analytical or strategic tasks, facing undefined problems, or facing analysis paralysis—requires explicit problem definition before proceeding.
Popular docs & writing skills
grill-with-docs
mattpocock/skills
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
lark-markdown
open.feishu.cn
飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。
writing-beats
mattpocock/skills
Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.
writing-shape
mattpocock/skills
Writing, exploit: shape raw material into an article, paragraph by paragraph.
writing-fragments
mattpocock/skills
Writing, explore: mine raw fragments, no structure yet.
writing-for-agents
mattpocock/skills
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.