convez.ai
SkillEscrita & ConteúdoIntermediário
MCTO-the-dig

Gerador de Scripts para Vídeos de Artigos

MCTO-the-dig/article-video-script-claude-script

Converte artigos em scripts de vídeo com voz autêntica para TTS

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill Claude que transforma artigos em scripts de voz falada de 150–250 palavras, otimizados para síntese de áudio (ElevenLabs). Executa análise em duas passes (espinha editorial + voz autêntica) e estrutura o resultado em formato de gancho → problema → pontos-chave → encerramento, pronto para produção.

Instalação

$npx convez-ai MCTO-the-dig/article-video-script-claude-script

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Criar scripts teaser para vídeos introdutórios de artigos
  • Gerar narração de visão geral mantendo tom e dicção do autor
  • Produzir conteúdo de vídeo para síntese de áudio com marcadores ElevenLabs

Veredito

Skill especializado e bem-estruturado para fluxo específico de produção de vídeo. Padrão de duas passes garante autenticidade vocal e editorial, mas acoplamento forte ao contexto de Digitising Events limita reuso. Útil para equipes que automatizam scripts de vídeo em larga escala.

README

A tradução para o português deste README ainda está na fila.

article-video-script

A Claude skill for generating first-draft spoken-word scripts from Digitising Events articles. Produces a 150–250 word teaser script for use as an article overview or intro video, voiced in the author's register and formatted for ElevenLabs TTS production.


What It Does

The skill generates a structured script designed to create enough curiosity that the viewer wants to read the full article. It is not a summary — it interprets and voices the argument.

It runs two internal passes before writing:

  • Pass 1 — Editorial Spine: Reads the executive summary and key points to establish the article's central claim, strongest supporting points, and where the author lands.
  • Pass 2 — Voice and Texture: Reads the full article hunting for the most idiosyncratic phrases, unexpected metaphors, and the emotional register. These are carried into the script. Generic prose is the explicit failure mode.

The script follows a fixed five-part structure: Hook → Problem Frame → Key Points → Return to Hook → Close. The hook and return form a deliberate bookend; the strongest point goes first or last, never in the middle.

Voice direction markers for ElevenLabs are added sparingly (maximum four per script).


Directory Structure

article-video-script/
├── SKILL.md
└── references/
    └── scriptwriting-frameworks.md

Installation

  1. Clone or download this repository.
  2. Copy the article-video-script/ folder (including the references/ subdirectory) to your skills directory:
cp -r article-video-script/ /mnt/skills/user/article-video-script/
  1. Ensure the skill is registered in your Project's skill manifest or available_skills block:
<skill>
  <name>article-video-script</name>
  <description>
    Generates a first-draft spoken-word script for a Digitising Events article overview video. 
    Use this skill whenever Adam asks to generate a video script, overview script, or article 
    intro script from a published or draft article. Also triggers on phrases like "write the 
    video script", "create the overview script", "script this article", or "generate the video 
    overview". Always use this skill for DE video script generation — do not attempt to write 
    DE video scripts without it.
  </description>
  <location>/mnt/skills/user/article-video-script/SKILL.md</location>
</skill>
  1. Verify Claude can read the skill by asking it to confirm the skill is loaded, or by triggering a script generation on a short test article.

Usage

Trigger phrases

Claude will automatically load and run this skill when it detects any of the following:

  • "Write the video script"
  • "Create the overview script"
  • "Script this article"
  • "Generate the video overview"
  • Any request to generate a DE article video script or intro

Required inputs

The skill requires both of the following before it will proceed:

InputPurpose
Executive summary and key pointsEditorial spine — HITL-verified; determines what the script says
Full article textVoice and texture layer — source of authentic phrasing

If either input is missing, Claude will ask for it before generating the script.

Example prompt

Write the video script for this article.

Executive summary and key points:
[paste summary]

Full article:
[paste article text]

Or with a Google Doc:

Write the video script. Executive summary below, full article at this link: 
https://docs.google.com/document/d/[doc-id]

Executive summary:
[paste summary]

Output Format

A single block of plain prose with no headers, section labels, or bullet points. ElevenLabs voice direction markers are inline where used. Word count appears at the end in brackets.

Example output structure (prose, not labelled):

[emphatic] Bold opening claim or question that creates a curiosity gap.

One to two sentences establishing why this matters right now and what 
goes wrong if it's ignored.

The two or three strongest insights from the article, moving naturally 
between them as if speaking to a peer.

[emphatic] Echo of the opening — the loop closes here. Enough resolution 
to feel satisfying; full resolution stays in the article.

[determined] The author's stake in the ground. The most forward-looking 
or consequential conclusion. The full argument is in the article.

[187 words]

Voice Direction Markers

MarkerUse
[emphasise]Single most important word or phrase in the hook
[thoughtful]Where the script slows to let a point land
[emphatic]Return to hook and the close
[determined]Where the author's stake in the ground is clearest

Rules: Maximum four markers per script. Never stack two consecutively. Never use on filler or transition language.


Word Count

BoundaryCountNotes
Floor150 wordsBelow this the argument is not being done justice
Ceiling250 wordsAbove this you are summarising, not teasing
CTA lineExcluded"The full argument is in the article" sits outside the count

A tight single-claim article lands around 160–180 words. A piece with a framework or mechanism that needs naming can stretch to 230–240.


Important Behaviour Notes

  • The two-pass logic is the core of the skill. Pass 1 and Pass 2 must not be collapsed into a single read.
  • The executive summary takes precedence over the full article if there is any tension between them.
  • The skill will not flatten the author's voice into neutral paraphrases. Idiosyncratic phrases and unexpected metaphors are carried in deliberately.
  • This skill produces a first draft. Human editorial review is the exit condition — not further AI iteration.

Reference Files

FileContents
references/scriptwriting-frameworks.mdCuriosity Gap techniques, Voice Preservation guidance — consulted when the hook is not obvious or the voice feels flat in draft

Part of the Digitising Events Skills System

This skill is one of several used to run the Digitising Events content workflow. Related skills:

  • de-editorial-checker — three-pass editorial review for DE article drafts
  • skill-creator — for building and testing new skills

Skills follow the convention: SKILL.md contains the executable procedure; reference files in references/ contain supporting frameworks the procedure draws on when needed.

Ver o original no GitHub

Bom para

Relacionados