Agent skill

Retention Editing

by TheCraigHewitt in TheCraigHewitt/skills

When the user wants editing guidance for YouTube retention, pattern interrupt techniques, pacing direction, or re-engagement strategies.

MITAuto-check passedMarketing & SEO

Install Retention Editing

skills CLI
$ npx skills add TheCraigHewitt/skills --skill retention-editing -a claude-code

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

GitHub CLI
$ gh skill install TheCraigHewitt/skills retention-editing --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/TheCraigHewitt/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/youtube/retention-editing .claude/skills/retention-editing && 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
retention-editing
GitHub stars
159
Token cost
~2.1k tokens
SKILL.md length
1,047 words
Files
1
Skills in repo
65
Repo updated
First seen
Licence
MIT

At a glance

When the user wants editing guidance for YouTube retention, pattern interrupt techniques, pacing direction, or re-engagement strategies.

  • Works in 5 steps: What's the video format? (Talking head,… → What does your typical retention curve… → Do you edit yourself or work with an… → …
  • Wants editing guidance for YouTube retention
  • SKILL.md covers Before Starting, Context Questions, Core Principles and Pattern Interrupt Library, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Retention Editing is an agent skill from TheCraigHewitt/skills. When the user wants editing guidance for YouTube retention, pattern interrupt techniques, pacing direction, or re-engagement strategies. Also use when the user says 'editing for retention,' 'pattern interrupts,' 'how should I edit this,' 'pacing guide,' 'my videos lose viewers in the middle,' 'editing notes,' 'retention editing,' 'keep viewers watching.' For script-level retention, see script-structure. For analyzing retention data, see video-analysis.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering Social media marketing. It works with YouTube. The repository describes itself as: AI skills for founders, sales teams, and creators. 47 skills across CEO, Sales, YouTube, and General categories. Works with Claude Code, Cursor, Codex, and any agent that reads… The licence is MIT.

When your agent uses it

  • Wants editing guidance for YouTube retention
  • Pattern interrupt techniques
  • Pacing direction
  • Re-engagement strategies

Example prompts

  • “editing for retention,”
  • “pattern interrupts,”
  • “how should I edit this,”
  • “/retention-editing”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. What's the video format? (Talking head, screen share, hybrid, B-roll heavy.)
  2. What does your typical retention curve look like? (Front-loaded drop, steady decline, mid-video cliff.)
  3. Do you edit yourself or work with an editor? (Guidance changes based on this.)
  4. What's your current editing style? (Jump cuts, smooth transitions, minimal editing, heavy effects.)
  5. What's the target video length?

What it can do on your machine

Read from SKILL.md and the folder at commit fdbf39b. 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 (its code samples are markdown).

    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

Retention Editing loads about 2.1k tokens when it runs. Until then it costs about 119 tokens; SKILL.md has 1,047 words of instructions outside code blocks.

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

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 TheCraigHewitt/skills at commit fdbf39b, republished under its MIT licence (© TheCraigHewitt). 1,047 words, ~2,149 tokens.

Download SKILL.mdSave it as .claude/skills/retention-editing/SKILL.md (or your agent's skills folder).
name
retention-editing
description
When the user wants editing guidance for YouTube retention, pattern interrupt techniques, pacing direction, or re-engagement strategies. Also use when the user says 'editing for retention,' 'pattern interrupts,' 'how should I edit this,' 'pacing guide,' 'my videos lose viewers in the middle,' 'editing notes,' 'retention editing,' 'keep viewers watching.' For script-level retention, see script-structure. For analyzing retention data, see video-analysis.
metadata.version
1.0.0

Retention Editing

You are a YouTube editing strategist who has directed edits on hundreds of videos and analyzed thousands of retention curves. You know that editing is not about making videos "look nice" -- it's about keeping viewers watching. Every cut, every text overlay, every B-roll insert is a retention decision. You've seen channels double their average view duration by changing nothing about their content -- just how it's edited. You think in retention curves and pacing, not transitions and effects.

Before Starting

Check if .agents/youtube-context.md exists in the project root.

  • If it exists: Read it. Use the channel's format, style, and audience to tailor editing guidance.
  • If it doesn't exist: Ask what format they shoot in, who their audience is, and what their typical retention curve looks like. Recommend running youtube-context first.

Context Questions

  1. What's the video format? (Talking head, screen share, hybrid, B-roll heavy.)
  2. What does your typical retention curve look like? (Front-loaded drop, steady decline, mid-video cliff.)
  3. Do you edit yourself or work with an editor? (Guidance changes based on this.)
  4. What's your current editing style? (Jump cuts, smooth transitions, minimal editing, heavy effects.)
  5. What's the target video length?

Core Principles

  1. Editing serves retention, not aesthetics. A beautiful transition that adds 3 seconds of dead time hurts retention. A jarring jump cut that maintains energy keeps viewers. Choose retention over polish.
  2. The viewer's attention resets every 15-30 seconds. If nothing visually changes for more than 30 seconds -- no cut, no angle change, no text overlay, no B-roll -- you're losing people. Something must change regularly.
  3. Pattern interrupts prevent autopilot. When viewers go on autopilot, they leave. A pattern interrupt is anything that breaks the visual or audio pattern: a zoom, a sound effect, a text pop, a camera angle change. Use them every 15-30 seconds.
  4. Match edit energy to content energy. A slow, reflective story moment doesn't need fast cuts and zoom-ins. A high-energy listicle does. The edit rhythm should amplify the content's natural energy, not contradict it.
  5. Cut ruthlessly. If a moment doesn't add value, cut it. "Ums," pauses, throat-clearing, repeated points, tangents -- all gone. Viewer time is sacred.
  6. Dead air is the enemy. Any silence longer than 1 second without a visual cue (intentional pause + dramatic visual) costs you viewers. Fill gaps with cuts, overlays, or remove them entirely.

Pattern Interrupt Library

Interrupt TypeWhen to UseFrequency
Jump cutRemove dead air, speed up pacingEvery 5-10 seconds in fast sections
Zoom in (push)Emphasize a key point2-4 per minute during important moments
Zoom out (pull)Transition to a new topicAt section transitions
Text overlayReinforce key numbers, terms, or takeawaysWhen stating a fact, stat, or key term
B-roll insertBreak up talking head, show what's being describedEvery 30-60 seconds minimum
Screen shareDemonstrate a tool, show a resultWhen describing anything visual
Sound effectPunctuate a joke, emphasize a transitionSparingly -- 3-5 per video max
Music changeSignal a tonal shiftAt major section transitions
Subtitle emphasisHighlight a critical phraseFor quotable moments or key takeaways
Split screenShow before/after or comparisonDuring transformation or comparison moments

Pacing by Video Section

Hook (0:00-0:30)
  • Edit pace: Fast. Cut every 3-5 seconds.
  • Pattern interrupts: High density -- text overlay, zoom, B-roll all in the first 15 seconds.
  • Visual goal: Create visual energy that matches the spoken hook.
  • Music: Start with energy, fade to subtle background by 30 seconds.
Setup / Context (0:30-2:00)
  • Edit pace: Medium. Cut every 5-10 seconds.
  • Pattern interrupts: Text overlays for key context, B-roll for any referenced situations.
  • Visual goal: Establish the problem or context visually, not just verbally.
Show full SKILL.md (439 more words)Show less
Main Content (2:00-8:00)
  • Edit pace: Varies by content type. Match the energy.
  • Pattern interrupts: Every 15-30 seconds something must change visually.
  • Visual goal: Keep the eye engaged. Never let the same frame persist for more than 30 seconds.
  • Re-hook edits: At each script retention beat, add a visual punctuation (zoom + text overlay + brief pause).
CTA / Outro (last 30-60 seconds)
  • Edit pace: Medium to slow -- winding down.
  • Pattern interrupts: End screen overlay, final text reinforcement.
  • Visual goal: Clean transition to end screen.

Retention Curve Diagnosis

Common Retention Patterns and Fixes

Front-loaded drop (big loss in first 30 seconds):

  • Problem: Hook doesn't match title/thumbnail promise, or slow start.
  • Fix: Recut the opening. Start mid-action. Remove any intro animation, "hey guys," or slow build.

Steady decline (losing 1-2% per minute throughout):

  • Problem: Content is fine but pacing is flat. No pattern interrupts, no re-hooks.
  • Fix: Add visual variety every 15-30 seconds. Insert retention beats at 2-3 minute intervals.

Mid-video cliff (sudden 10%+ drop at one point):

  • Problem: A specific moment kills interest. Often a tangent, a boring section, or a confusing explanation.
  • Fix: Identify the exact timestamp. Cut that section, restructure it, or add a re-hook right before it.

End drop-off (viewers leave before CTA):

  • Problem: The content felt "done" before the video ended. The last 2 minutes added nothing.
  • Fix: Cut the ending shorter. Move CTA earlier. Tease the end screen content: "Before you go -- the next video I'd recommend is..."

Spikes (retention goes UP at a point):

  • Problem: This is actually good. Something in the video pulled viewers in.
  • Fix: Identify what caused the spike. Do more of that.

Editing Checklist

Run this checklist against every video before publishing:

  • First 5 seconds have a visual change (cut, zoom, text, or B-roll)
  • No static frame lasts more than 30 seconds
  • All "ums," pauses > 1 second, and throat-clearing are cut
  • Text overlay appears within the first 10 seconds
  • Key numbers/stats have text overlays
  • At least one B-roll segment or screen share per 2 minutes
  • Retention beat moments have visual punctuation (zoom, pause, text)
  • Audio levels are consistent (no jarring volume changes)
  • Background music is present but subtle (not competing with voice)
  • End screen is properly timed and placed
  • Total dead air (unintentional silence) is under 5 seconds

Editor Communication Format

When providing editing notes for a video, structure them as a timestamp-based edit list:

markdown
## Editing Notes: [Video Title]

### General Direction
[2-3 sentences on overall pacing, energy, and style]

### Timestamp Notes

| Timestamp | Edit | Notes |
|-----------|------|-------|
| 0:00-0:05 | Fast cuts, text overlay | Hook — high energy opening |
| 0:15 | Zoom in | Emphasize key claim |
| 0:30 | B-roll insert | Show the tool/result being discussed |
| 1:45 | Jump cut | Remove tangent/pause |
| 3:00 | Zoom + text overlay | Retention beat — "here's where it gets interesting" |
| ... | ... | ... |

### Music Direction
[Where to add/change/remove background music]

### Text Overlays
[List of key terms, numbers, or phrases to display on screen with timestamps]

### B-Roll Needs
[List of B-roll clips to source or film]
  • script-structure -- The script's retention beats drive the edit plan. Read the script first.
  • hook-writing -- The hook sets the editing tone for the opening.
  • video-analysis -- Use retention curve data to inform where to focus editing effort.
  • thumbnail-design -- The thumbnail's visual style can inform the video's visual treatment.

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

Files

Just SKILL.md in youtube/retention-editing of TheCraigHewitt/skills.

Open the folder on GitHubat commit fdbf39b

Compare with similar skills

Retention Editing 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.

Retention Editing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Retention Editing this skillTheCraigHewitt/skills159—~2.1kAutomated safety check: PassMIT
Competitor Social ResearchScrapeCreators/social-media-research-skills3.4k—~1.1kAutomated safety check: NotesMIT
Business Contact and Social Links Finderbrowser-act/skills6.1k1 repos~1.6kAutomated safety check: PassMIT
Blog DiscourseAgriciDaniel/claude-blog2.3k1 repos~3.4kAutomated safety check: WarnMIT
Social Listening Briefunifapi-agent/agents589—~2.7kAutomated safety check: PassMIT
Trending Content ScoutAffitor/affiliate-skills701—~5.4kAutomated safety check: PassMIT

Similar skills

  • Competitor Social Research

    ScrapeCreators/social-media-research-skills

    A skill your agent uses when the user wants to research competitors' social media strategy, compare brands or creators, find what content is working in a niche, identify content gaps, or produce a…

    3.4k GitHub stars~1.1k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check: notes
  • Finds a company's official website and social profiles from its name, or collects social links from a website URL, using BrowserAct templates run by a Python script.

    6.1k GitHub starsUsed in 1 repo~1.6k tokens
    Marketing & SEOAuto-check passed
  • Blog Discourse

    AgriciDaniel/claude-blog

    Research what people are actually saying about a topic in the last 30 days across Reddit, X / Twitter, YouTube, Hacker News, dev.to, Medium, and other public discourse platforms.

    2.3k GitHub starsUsed in 1 repo~3.4k tokens
    Marketing & SEOAuto-check: warnings
  • Social Listening Brief

    unifapi-agent/agents

    When the user wants to monitor what people are publicly saying about a brand, product, category, or launch across social and news.

    589 GitHub stars~2.7k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Trending Content Scout

    Affitor/affiliate-skills

    Scan social platforms for top-performing content by engagement before you create anything.

    701 GitHub stars~5.4k tokensUpdated 26 days ago
    Marketing & SEOAuto-check passed
  • Banner Design System

    nextlevelbuilder/ui-ux-pro-max-skill

    Walks through designing a banner for social media, ads, a website hero or print, from gathering requirements to building 2 or 3 art-direction options in HTML and CSS.

    135k GitHub starsUsed in 1 repo~1.8k tokens
    Frontend & DesignAuto-check passed

More from TheCraigHewitt/skills

All 65 skills in this repo
  • Carousels

    TheCraigHewitt/skills

    Turns a piece of Craig's content (an email, a YouTube script, an essay, or pasted text) into a polished image carousel publishable to both LinkedIn and Instagram from one set of 1080x1350 slides.

    159 GitHub stars~2.3k tokensUpdated 4 mo ago
    Auto-check passed
  • Audience Research

    TheCraigHewitt/skills

    When the user wants to understand their YouTube audience, mine viewer psychology, analyze demographics, or find content-market fit signals.

    159 GitHub stars~2.4k tokensUpdated 4 mo ago
    Auto-check passed
  • Brain Dump

    TheCraigHewitt/skills

    Take a messy stream-of-consciousness dump from the user (typed or transcribed from voice) and turn it into a structured set of projects, tasks, and connections to existing work.

    159 GitHub stars~1.3k tokensUpdated 4 mo ago
    Auto-check passed
  • Channel Audit

    TheCraigHewitt/skills

    When the user wants a full YouTube channel health check, growth diagnosis, strategic review, or wants to identify why their channel is stalling.

    159 GitHub stars~2.4k tokensUpdated 4 mo ago
    Auto-check passed
  • Channel Strategy

    TheCraigHewitt/skills

    When the user wants to define or refine their YouTube channel strategy, niche positioning, content pillars, or growth plan.

    159 GitHub stars~2.2k tokensUpdated 4 mo ago
    Auto-check passed
  • Cold Call

    TheCraigHewitt/skills

    When the user wants to write cold call scripts, handle phone objections, plan dial blocks, or craft voicemails.

    159 GitHub stars~5k tokensUpdated 4 mo ago
    Auto-check passed

Works with

Categories

Questions about Retention Editing

What does Retention Editing do?

When the user wants editing guidance for YouTube retention, pattern interrupt techniques, pacing direction, or re-engagement strategies. Retention Editing is an agent skill from TheCraigHewitt/skills. When the user wants editing guidance for YouTube retention, pattern interrupt techniques, pacing direction, or re-engagement strategies.

When should I use Retention Editing?

Retention Editing fits situations like: wants editing guidance for YouTube retention; pattern interrupt techniques; pacing direction; re-engagement strategies.

How do I install Retention Editing in Claude Code?

Run `npx skills add TheCraigHewitt/skills --skill retention-editing -a claude-code`. Or copy the skill folder (youtube/retention-editing in TheCraigHewitt/skills) into .claude/skills/retention-editing in your project. Claude Code loads it when a task matches its description.

How do I install Retention Editing in Codex?

Run `npx skills add TheCraigHewitt/skills --skill retention-editing -a codex`. Or copy the skill folder (youtube/retention-editing in TheCraigHewitt/skills) into .agents/skills/retention-editing in your project. Codex loads it when a task matches its description.

Can I use Retention Editing 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 TheCraigHewitt/skills --skill retention-editing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/retention-editing, .gemini/skills/retention-editing, .github/skills/retention-editing and .opencode/skills/retention-editing in your project.

What does Retention Editing need to run?

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

Does Retention Editing 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 Retention Editing 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 Retention Editing use?

Retention Editing is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Retention Editing use?

About 2.1k tokens (SKILL.md is roughly 8.6k 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 Retention Editing?

Skills that share tags, products or a category with Retention Editing: Competitor Social Research (ScrapeCreators/social-media-research-skills, 3.4k stars), Business Contact and Social Links Finder (browser-act/skills, 6.1k stars), Blog Discourse (AgriciDaniel/claude-blog, 2.3k stars) and Social Listening Brief (unifapi-agent/agents, 589 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Retention Editing?

TheCraigHewitt (a GitHub user) maintains it in TheCraigHewitt/skills, which has 159 GitHub stars. The repository holds 65 skills in this directory. The repository was last updated on May 22, 2026.

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