Skip to main content
skill CX Codex

scriptwriting-methodology — Claude Code skill: what it does

scriptwriting-methodology guides your agent in drafting and critiquing direct-response video scripts. Keeps sponsored segments under 60 words for a 20-second spot.

MIT 267 installs ★ 48 updated 2026-09-27

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add mike-coulbourn/claude-vibes --skill scriptwriting-methodology -a claude-code
Open on GitHub

What scriptwriting-methodology does

This skill equips the agent with direct response frameworks built specifically for short-form video ads, affiliate mentions, and sponsored clips. Its core DR Formula breaks a 20-second video into strict time windows: a 3-second hook, problem, solution, value proposition, social proof, and a final call to action. The total script stays at 60 words or less.

It includes secondary frameworks like PAS, AIDA, and Justin Welsh's PAIPS, alongside categorized hook formulas such as Quick Fix or Curiosity Loop. Product value is structured using Alex Hormozi's Value Equation. A pre-flight checklist inspects whether the script sounds natural when spoken aloud and strips out corporate marketing speak.

Hard sells belong strictly on warm audiences. Deploying hard sell tactics to cold viewers drives unsubscribe rates up to 25%.

What it helps with

  • draft a 20-second sponsored video script under 60 words
  • critique a draft script against a direct response checklist
  • pick a hook template tailored for cold traffic
  • structure an offer using Hormozi's Value Equation

Example prompts for the agent

  • Write a 20-second sponsored segment for a productivity app using the DR Formula.
  • Review this video script draft against the quality checklist and suggest two alternative hooks.
  • Adapt this product pitch into the PAIPS framework with a soft CTA.

How to install scriptwriting-methodology

1Skills CLI (Vercel)

npx skills add mike-coulbourn/claude-vibes --skill scriptwriting-methodology -a claude-code

2Manually: put the files in place

~/.claude/skills/scriptwriting-methodology/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/scriptwriting-methodology/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about scriptwriting-methodology

How do I install scriptwriting-methodology in Claude Code?

Run npx skills add mike-coulbourn/claude-vibes --skill scriptwriting-methodology -a claude-code. The skill file will be placed in ~/.claude/skills/scriptwriting-methodology/SKILL.md.

What does scriptwriting-methodology do?

It gives your agent structured frameworks and timing rules to draft and critique direct-response video scripts, hooks, and calls to action.

Which script frameworks are included?

The primary 6-step Direct Response structure, plus PAS, AIDA, and Justin Welsh's PAIPS.

Source text

SKILL.md · MIT
---
name: scriptwriting-methodology
description: Use when writing or critiquing video scripts meant to sell, such as sponsored segments, affiliate content, ads, hooks, and calls to action. Keywords - direct response, DR formula, PAS, AIDA, hook formulas, CTA, script structure, conversion copy for video.
---

# Scriptwriting methodology for sponsored content

## Core framework: the DR Formula

The **Direct Response (DR) Formula** is the industry standard for sponsored and affiliate video scripts:

### Structure

1. **HOOK (0-3 seconds)**: Stop the scroll
2. **PROBLEM (3-7 seconds)**: Make them feel understood
3. **SOLUTION (7-12 seconds)**: Introduce the product
4. **VALUE PROP (12-15 seconds)**: Why this product is different
5. **SOCIAL PROOF (15-18 seconds)**: Results and credibility
6. **CTA (18-20 seconds)**: Clear call to action

### Key principle
Scripts should be **60 words or less for a 20-second video**. The structure should feel like storytelling, not advertising.

---

## Alternative frameworks

### PAS (Problem-Agitate-Solution)
Simpler structure for short-form content:

1. **Problem (15%)**: Identify the specific problem
2. **Agitate (25%)**: Intensify the pain so they feel it
3. **Solution (60%)**: Present the product as the answer

**Key insight**: Agitation is the most overlooked step. "Hammering the problem home gets under the reader's skin."

### AIDA (Attention-Interest-Desire-Action)
Classic framework from 1898, still effective:

1. **Attention**: Punchy hook (first 1-3 seconds)
2. **Interest**: Why should they care? What's in it for them?
3. **Desire**: Convert interest into want through emotion, social proof
4. **Action**: Clear call-to-action

### PAIPS (Problem-Agitate-Intrigue-Positive Future-Solution)
Justin Welsh's evolution of PAS:

1. **Problem**: Identify the problem
2. **Agitate**: Intensify emotional response
3. **Intrigue**: Create curiosity about the solution
4. **Positive Future**: Paint a picture of life after the problem is solved
5. **Solution**: Present your offering

---

## Hook formulas

The hook is **71% of the battle**. Viewers decide to stay or scroll in 1-3 seconds.

### Proven hook types

| Type | Template | Example |
|------|----------|---------|
| Correction | "Stop doing [X]. Do this instead." | "Stop applying sunscreen like this..." |
| Insider Secret | "No one talks about this in [industry]..." | "No one talks about this in skincare..." |
| Quick Fix | "Here's how to fix [problem] in 60 seconds" | "Here's how to fix oily skin in 60 seconds" |
| Curiosity Loop | "Watch what happens when I..." | "Watch what happens when I add this to my routine" |
| Transformation | "I can't believe this [product] actually..." | "I can't believe this serum actually..." |
| Call-Out | "If you're a [person], this is for you" | "If you're over 30 with dry skin, this is for you" |
| Personal Mistake | "This mistake cost me [result]" | "This mistake cost me 6 months of breakouts" |

### Hook stacking
Combine multiple hook types for maximum impact:
- **Visual hook**: Motion, expressions, text overlay
- **Auditory hook**: Trending audio, snappy voiceover
- **Content hook**: Bold statement, question, opinion
- **Emotional hook**: Taps into stress, joy, frustration

---

## CTA best practices

### The Data
- Affiliates who test CTAs see **49% improvement** in conversion
- CTA placement matters: End of video is standard, but mid-video CTAs can work

### CTA templates

**Soft CTAs** (for cold audiences):
- "Link in bio if you want to check it out"
- "I'll drop the link if you're curious"

**Medium CTAs**:
- "Use my code [X] for [discount]"
- "Link in description to grab yours"

**Strong CTAs** (for warm audiences):
- "Tap the link now. This deal ends [date]"
- "Click the product tag to see the price"

### Writing effective CTAs
1. **Keep it short**: 1-2 sentences
2. **Be specific**: Tell them exactly what to do
3. **Match urgency to context**: Don't fake scarcity
4. **Use action words**: grab, snag, check out, try

---

## Soft sell vs hard sell

### Research findings
- Soft sell emails get **31% positive response** vs hard sell
- Hard sell has **25% unsubscribe rate** vs 10% for soft sell
- Drip campaigns (soft sell) linked to **50% higher conversion**

### When to use each

**Soft Sell** (most creator content):
- Best for cold audiences
- Builds trust before asking
- Creates positive brand association

**Hard Sell**:
- Only for audiences already familiar with you
- Limited-time offers to engaged followers
- When you have one shot at closing

### The Rule
"The hardness of your sell should increase proportionally to the viewer's progression through the sales funnel."

---

## Hormozi's Value Equation

Use this when describing product value:

```
Value = (Dream Outcome × Perceived Likelihood) / (Time Delay × Effort Required)
```

**To maximize value in your script**:
- Emphasize the dream outcome
- Build confidence it will work (social proof)
- Minimize perceived time to results
- Minimize perceived effort required

---

## Script quality checklist

Before finalizing any script:

- [ ] Hook lands in first 3 seconds
- [ ] Problem section creates emotional connection
- [ ] Solution feels natural, not salesy
- [ ] Value prop differentiates from alternatives
- [ ] Social proof is specific and credible
- [ ] CTA is clear and actionable
- [ ] Sounds like the creator would actually say it
- [ ] Can be read aloud naturally
- [ ] Fits the target length
- [ ] No corporate marketing language

© mike-coulbourn · MIT · mike-coulbourn/claude-vibes

Similar skills

All skills for Marketing and content →

From the same set7

Project sponsors

Companies that keep this analytics open