Modo
Agendar llamada

retention-editing: editar videos de YouTube para que no los abandonen

Le da a Claude el criterio de un director de edición de YouTube: dónde cortar, qué cambiar en pantalla y cada cuánto, y cómo leer la curva de retención.

retention-editing: editar videos de YouTube para que no los abandonen

Respuesta rápida

Qué es
retention-editing es una skill de Craig Hewitt (licencia MIT) que le enseña a Claude a planificar la edición de un video de YouTube para que la gente no lo abandone a la mitad.
Qué le das
El formato del video, su duración, la transcripción con tiempos y cómo se ve tu curva de retención
Qué te devuelve
Un diagnóstico de dónde se va la gente y notas de edición con minuto y segundo, listas para tu editor
Licencia
MIT
En GitHub
175 estrellas · actualizada el
Revisada por Claura

Instálala en una línea para todos tus proyectos, en Claude Code, Cursor, Codex y más:

npx skills add thecraighewitt/skills --skill retention-editing -g

Funciona en

Claude CodeEn ~/.claude/skills/
CursorEn ~/.agents/skills/
CodexEn ~/.agents/skills/
Gemini CLIEn ~/.agents/skills/

Pedidos para probarla

Con la skill instalada, copia uno y pégaselo a tu agente tal cual, o cambia los datos por los tuyos.

  • Revisa la transcripción de mi video de YouTube [pega la transcripción] y marca dónde se va a ir la gente y qué cortar.

  • Arma el plan de edición de mi video de 12 minutos: dónde van los cambios de plano, los textos en pantalla y los cortes.

  • Reescribe los primeros 30 segundos de este video para que la gente no lo abandone.

#Qué hace

retention-editing es una skill de Craig Hewitt, parte de su colección de skills para YouTube. Antes de opinar busca .agents/youtube-context.md con los datos del canal; si no existe, pregunta cinco cosas: formato (alguien hablando a cámara, pantalla compartida, mixto o con mucho material de apoyo), forma de la curva de retención, si editas tú o un editor, estilo actual y duración objetivo. Trabaja con seis principios: la edición sirve a la retención y no a la estética, la atención se reinicia cada 15 a 30 segundos, los cambios de patrón evitan el piloto automático, la energía de la edición acompaña la del contenido, se corta sin piedad y cualquier silencio de más de un segundo sin un motivo visual cuesta espectadores.

Trae una biblioteca de 10 cambios de patrón con cuándo usarlos y cada cuánto: cortes cada 5 a 10 segundos en las partes rápidas, acercamientos de 2 a 4 por minuto en los puntos clave, material de apoyo cada 30 a 60 segundos como mínimo, efectos de sonido con moderación (3 a 5 por video). Define el ritmo por sección: gancho (0:00 a 0:30, un corte cada 3 a 5 segundos), contexto (0:30 a 2:00), contenido principal (2:00 a 8:00, algo cambia en pantalla cada 15 a 30 segundos) y cierre.

Diagnostica cinco formas de curva de retención con su causa y su arreglo: caída fuerte al inicio, descenso parejo de 1 a 2 % por minuto, un precipicio de más del 10 % en un punto, abandono antes del cierre y subidas, que conviene repetir. Cierra con una lista de 11 controles antes de publicar (cambio visual en los primeros 5 segundos, ningún cuadro fijo más de 30 segundos, silencio involuntario total menor a 5 segundos, entre otros) y una plantilla de notas para el editor con tabla de tiempos, dirección de música, textos en pantalla y material de apoyo a conseguir.

#Cómo aplicarla a tu negocio

Caso de ejemplo: un estudio contable publica en YouTube un video de 10 minutos por semana sobre impuestos para monotributistas. Lo edita un freelancer, y la gráfica de retención muestra que en el minuto 4 se va de golpe mucha gente.

  1. Le das el contexto. La transcripción con tiempos, el formato (la contadora hablando a cámara con pantalla compartida) y la curva: «perdemos un 15 % de golpe en el 4:10 y después baja parejo».
  2. Recibes el diagnóstico. La skill lo clasifica como precipicio a mitad del video y busca en la transcripción qué pasa ahí, por ejemplo una explicación larga de una norma sin nada en pantalla. Propone recortar ese tramo, agregar un texto con la cifra clave y un gancho justo antes.
  3. Recibes las notas para el editor. Una tabla con minuto y segundo: cortes rápidos en el gancho, acercamiento en el 0:15 para remarcar la promesa, pantalla compartida con la planilla en el 2:30, texto en pantalla en cada fecha de vencimiento.
  4. Controlas antes de publicar. Pasas la lista de 11 puntos sobre el corte final.

Las cifras son de ejemplo: el valor está en que el editor recibe indicaciones concretas en lugar de un «hazlo más dinámico».

#Cómo instalarla

Es una skill agent-agnostic: el mismo SKILL.md corre en cualquier agente.

  • Con una línea, para cualquier agente: npx skills add thecraighewitt/skills --skill retention-editing -g la deja instalada en todos tus proyectos.
  • A mano: copia la carpeta youtube/retention-editing/ a ~/.claude/skills/ para Claude Code, o a ~/.agents/skills/ para Cursor, Codex y Gemini CLI (las tres leen esa carpeta).
  • App de Claude: comprime la carpeta en un ZIP y súbela desde Customize, Skills, «Upload a skill».

No necesita claves de API ni programas extra. Menciona otras skills del mismo repositorio (de estructura de guion, ganchos, análisis de video y miniaturas) que se pueden instalar aparte, pero funciona sola. El SKILL.md completo (con la licencia y la fuente) está más abajo.

El SKILL.md completo

Skill original de Craig Hewitt (MIT). Fuente: github.com/thecraighewitt/skills/tree/main/youtube/retention-editing.

El archivo original está en inglés y va tal cual, sin traducir. Lo de arriba de esta ficha es el resumen en español: qué hace, cómo aplicarla y cómo instalarla.

Leer el archivo (158 líneas)

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.
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:

## 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]

Related Skills

  • 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.
Copiar el archivo tal cual
---
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
---

<!--
Skill original: retention-editing, de Craig Hewitt (https://github.com/thecraighewitt/skills/tree/main/youtube/retention-editing)
Licencia: MIT. Reproducida con atribución según los términos de la licencia.
Copia publicada en claura-ai.com/skills.
-->

# 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 Type | When to Use | Frequency |
|---------------|-------------|-----------|
| **Jump cut** | Remove dead air, speed up pacing | Every 5-10 seconds in fast sections |
| **Zoom in (push)** | Emphasize a key point | 2-4 per minute during important moments |
| **Zoom out (pull)** | Transition to a new topic | At section transitions |
| **Text overlay** | Reinforce key numbers, terms, or takeaways | When stating a fact, stat, or key term |
| **B-roll insert** | Break up talking head, show what's being described | Every 30-60 seconds minimum |
| **Screen share** | Demonstrate a tool, show a result | When describing anything visual |
| **Sound effect** | Punctuate a joke, emphasize a transition | Sparingly -- 3-5 per video max |
| **Music change** | Signal a tonal shift | At major section transitions |
| **Subtitle emphasis** | Highlight a critical phrase | For quotable moments or key takeaways |
| **Split screen** | Show before/after or comparison | During 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.

### 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]
```

## Related Skills

- **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.

Preguntas frecuentes sobre la skill retention-editing

¿Qué es la skill retention-editing y para qué sirve?

retention-editing es una skill de Craig Hewitt (github.com/thecraighewitt/skills, licencia MIT) que pone a Claude en el rol de estratega de edición para YouTube. Parte de que cada corte, cada texto en pantalla y cada inserto es una decisión de retención, no de estética. Te ayuda a diagnosticar en qué parte del video se va la gente, a decidir qué cambiar en pantalla y cada cuánto, y a escribir notas de edición con tiempos exactos para quien edita. Sirve si publicas videos largos y la gráfica de retención muestra caídas que no sabes explicar.

¿Edita el video por mí?

No. retention-editing no toca el archivo de video: devuelve el plan. Lo que entrega es un diagnóstico y una lista de cambios con minuto y segundo (cortes, acercamientos, textos, insertos, música), con el formato que usaría un director para pasarle indicaciones a su editor. Ese plan lo ejecutas tú en tu programa de edición, lo hace tu editor o lo aplica otra herramienta que sí edita, como un flujo con Remotion (guía para editar reels con Claude Code y Remotion) o la skill hyperframes para gráficos y placas. Es una limitación a tener en cuenta si buscabas edición automática.

¿Sirve para reels y TikTok o solo para YouTube?

Está escrita para videos largos de YouTube: sus tiempos por sección van del gancho de los primeros 30 segundos al contenido principal entre el minuto 2 y el 8, y el cierre en el último minuto. Varios principios sí se trasladan a videos cortos: que algo cambie en pantalla cada pocos segundos, eliminar silencios de más de un segundo, empezar en plena acción sin saludo ni animación de entrada. Pero los tiempos hay que comprimirlos, y la skill no trae reglas propias para formatos verticales. Para el primer segundo de un reel, complétala con 4 pasos para videos que no se puedan saltear.

¿Qué necesita para darme buenas notas? ¿Está en inglés?

No pide claves ni programas: solo contexto. Primero busca un archivo .agents/youtube-context.md con el formato, el estilo y el público de tu canal; si no existe, te hace cinco preguntas (formato, cómo es tu curva de retención, si editas tú o un editor, tu estilo actual y la duración objetivo) y te sugiere armar ese contexto con otra skill del mismo autor. Cuanto más concreto seas sobre la curva (en qué minuto cae y cuánto), mejor el diagnóstico; los datos los sacas de YouTube Studio o con youtube-analytics. Las instrucciones están en inglés; pide las notas en español.

Más skills de Video

Para seguir con este tema

Elegí qué cookies usamos