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 GitHubSkill 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-script1 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
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
- Clone or download this repository.
- Copy the
article-video-script/folder (including thereferences/subdirectory) to your skills directory:
cp -r article-video-script/ /mnt/skills/user/article-video-script/
- Ensure the skill is registered in your Project's skill manifest or
available_skillsblock:
<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>
- 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:
| Input | Purpose |
|---|---|
| Executive summary and key points | Editorial spine — HITL-verified; determines what the script says |
| Full article text | Voice 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
| Marker | Use |
|---|---|
[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
| Boundary | Count | Notes |
|---|---|---|
| Floor | 150 words | Below this the argument is not being done justice |
| Ceiling | 250 words | Above this you are summarising, not teasing |
| CTA line | Excluded | "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
| File | Contents |
|---|---|
references/scriptwriting-frameworks.md | Curiosity 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 draftsskill-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.