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
- Autor
- Craig Hewitt
- Licencia
- MIT
- Repositorio
- thecraighewitt/skills
- 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/skills/~/.agents/skills/~/.agents/skills/~/.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.
- 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».
- 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.
- 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.
- 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 -gla 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-contextfirst.
Context Questions
- What's the video format? (Talking head, screen share, hybrid, B-roll heavy.)
- What does your typical retention curve look like? (Front-loaded drop, steady decline, mid-video cliff.)
- Do you edit yourself or work with an editor? (Guidance changes based on this.)
- What's your current editing style? (Jump cuts, smooth transitions, minimal editing, heavy effects.)
- What's the target video length?
Core Principles
- 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.
- 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.
- 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.
- 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.
- Cut ruthlessly. If a moment doesn't add value, cut it. "Ums," pauses, throat-clearing, repeated points, tangents -- all gone. Viewer time is sacred.
- 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:
## 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
heygen-video: producir videos con avatar de IA desde Claude
Convierte a Claude en un productor de videos con presentador de HeyGen: te entrevista, escribe el guion, ajusta el encuadre del avatar y entrega el video terminado.

hyperframes: crear videos con HTML y renderizarlos a MP4
Hace que Claude arme videos como páginas HTML animadas (lanzamientos, explicativos, gráficos, clips verticales) y los convierta en un MP4 que sale igual cada vez.

video-ad-analysis: analizar video ads con IA y sacar los patrones que convierten
Deconstruye un video ad (hook, tácticas de persuasión, audiencia, CTA) y devuelve patrones accionables para replicar en tus creativos.
Para seguir con este tema
- Guía de Contenido con IAEl orden para empezar y las notas de este tema.Guía
- Skills de Claude y ChatGPT para video y reelsQué skills de Claude instalar para editar videos y reels: armado con código, subtítulos, avatar, ganchos, retención y análisis. Cómo usarlas en Claude y en ChatGPT.Skill
- 4 pasos para videos que no se puedan saltear (loop de la dopamina)El framework de 4 pasos (stakes, gran pregunta, headfake, rehook) que evita que salteen tu video de marca, con un ejemplo real por paso.Nota
AI KID
RE/MAX Patagon
Mateo Caño