Install in Claude Code
Copygit clone --depth 1 https://github.com/FerroxLabs/wayland /tmp/convert-transition && cp -r /tmp/convert-transition/resources/bundled-extensions/business-conversion/skills/convert-transition ~/.claude/skills/convert-transitionThen start a new Claude Code session; the skill loads automatically.
Definition
SKILL.md
# Convert Transition - The Donahoe Transition System
> *"Transitions are where most copy dies. The writer runs out of momentum, drops in a clunky connector, and the reader checks out. In Donahoe copy, transitions happen through energy and movement, not announcement phrases."* - The Donahoe Method, Framework 8
This skill replaces clunky filler transitions ("here's the thing", "look", "let me be straight with you") with the 10 Donahoe transition moves that work through energy and movement.
You either accelerate, decelerate, redirect, or detonate. The movement itself is interesting enough that the reader follows.
## When to Use
Trigger phrases: "fix my transitions", "donahoe transitions", "transition system", "kill the connector phrases", "kill here's the thing", "write a comparison bomb", "write an aside bomb", "move between sections", `/convert transition <draft section>`.
Use when:
- A draft has clunky filler transitions
- A specific section break feels stiff or breaks momentum
- You're inside a Chute pass (`convert-chute`) and need a specific transition move to deploy
- The writer used the same kind of transition 3+ times in a row
Do NOT use for:
- Engineering full-draft momentum (use `convert-chute`)
- Writing the asset's opening hook (use `convert-open`)
- Writing the close (use `convert-close`)
- Auditing the page (use `convert-audit`)
## Inputs
Required:
1. **The draft section(s)** - paste in the specific section break(s) where the transition needs work
2. **Direction of energy** - what are we moving from / to? (problem → solution / story → mechanism / proof → bullets / bullets → close / etc.)
Optional:
- **Voice samples / signature phrases** so transitions match the seller's voice
- **Reader temperature** (Cool audiences absorb Diagnostic well; Hot audiences love Escalation; Boiling audiences just need a Dismiss)
- `out_path` - caller-controlled output. Defaults via `build_report_path`.
## The Banned Filler Phrases
These are the connectors that signal you ran out of ideas. The reader feels the gear-grind. Kill on sight:
- "Here's the thing..." (apology for transitioning)
- "Look..." (defensive; signals coming pushback)
- "Let me be straight with you..." (hedge - implies you weren't being straight before)
- "Now, in this next section..." (announces structure, kills momentum)
- "Moving on..." (gives up entirely)
- "But wait!" (1990s infomercial energy)
- "Don't worry, because..." (reassurance no one asked for)
- "Believe me when I say..." (begging trust)
- "As I mentioned earlier..." (slows the read; treat the reader as if they're paying attention)
- "In conclusion..." / "To wrap up..." (kills momentum at the close)
When you find these, replace with one of the 10 moves below.
## The Transition Arsenal (10 moves)
### 1. The Comparison Bomb
Vivid, instant, no setup. Anchors a complex idea in one image.
**Pattern:** *"Think [familiar thing] on crack."* / *"It's like [X] but [Y]."* / *"[X], except for grown-ups."*
Examples:
- ✓ *"Think a webinar funnel - except the webinar is a 6-minute story and the funnel is a single page."*
- ✓ *"It's like cold-calling, but the customer makes the call."*
- ✓ *"Picture an agency retainer, except you keep all the margin."*
When to use: when you need to anchor a new concept fast and the reader has a familiar reference.
### 2. The Escalation
Dismisses what you just built up to build something bigger.
**Pattern:** *"And that's not even the good part..."* / *"That's the floor, not the ceiling..."* / *"Wait until you hear what happened on day eight..."*
Examples:
- ✓ *"And the leads in week one - that's the easy part. The thing that actually changed the business showed up in week three."*
- ✓ *"That $14k in 11 days? That was the proof of concept. The proof itself came six months later."*
When to use: when you've built up something impressive and want to set up something more impressive without seeming to oversell.
### 3. The Aside Bomb
Makes the most important point sound like an afterthought. The casual delivery IS the emphasis.
**Pattern:** *"Oh, and one more thing..."* / *"Almost forgot - [the load-bearing thing]"* / *"(Side note that's actually the whole point...)"*
Examples:
- ✓ *"Oh, and the part I almost forgot - Mike's revenue actually doubled the next month, not the same month. The system kept compounding after the first 30 days."*
- ✓ *"Side note that's actually the whole point: the only people this didn't work for were the ones who skipped Module 2."*
When to use: when the most important data point would land flat if you announced it. Aside makes it land harder.
### 4. The Interrupt
Creates urgency by stopping yourself. The reader thinks *"what's so important that he stopped mid-thought?"*
**Pattern:** *"Wait. Before I go any further..."* / *"Actually - hold on. Something I need to clarify before we continue..."*
Examples:
- ✓ *"Wait - before I keep going, I need to be honest about something. This doesn't work if you're not actively servicing customers right now. If you're pre-revenue, this is the wrong play. Different conversation. Now, assuming you ARE servicing customers..."*
- ✓ *"Hold on. I'm getting ahead of myself. Let me back up to the part where this actually clicked."*
When to use: when the reader needs to digest before the next claim, or when you want to disqualify wrong-fit readers without breaking the chute.
### 5. The Dismiss
A tangent deliberately planted as a teaser. You're opening a loop you won't close yet.
**Pattern:** *"But that's a whole other thing..."* / *"That's a different rabbit hole - we'll get to it later..."* / *"More on that in a minute."*
Examples:
- ✓ *"There's actually a second mechanism that compounds this - but that's a whole other conversation. We'll get there later."*
- ✓ *"And yes, there's a way to run this without paid traffic at all. More on that in section four."*
When to use: when you want to plant an open loop the reader carries forward.
### 6. The Diagnostic
CutMore from this repository
architectureSkill
|
bump-versionSkill
Use when bumping the Wayland version: update package.json, run checks, branch, commit, push, create PR, wait for merge, tag release.
fix-issuesSkill
|
fix-sentrySkill
|
i18nSkill
|
oss-prSkill
Use when creating a pull request, after committing changes, or when user invokes /oss-pr. Covers branch management, quality checks, commit, push, and PR creation.
pr-automationSkill
|
pr-fixSkill
|