AI-agents trainen om filmrecensievideo's te bewerken via CLI

Ontwikkelaars zijn eraan gewend geraakt om routinematige tekstgebaseerde taken te delegeren naar AI-assistenten: tests schrijven, patronen deployen of oude controllers refactoren. Maar tekstmodellen kunnen veel meer als ze duidelijke instructies krijgen en een handig terminalhulpmiddel. Repository narrator-ai-cli-skill demonstreert hoe je een hypothetische Cursor, Windsurf of Claude Code kunt omtoveren tot een autonome video-editor.

Het hele idee draait om het genereren van videoreviews en samenvattingen van films. Je schrijft een korte prompt naar de agent zoals "maak een komische review van The Shawshank Redemption," en het model regelt alles zelf: selecteert uit de catalogus, genereert een script, kiest een vertellerstem, voegt achtergrondmuziek toe en levert een link naar het fertige bestand.

Waarom een aparte vaardigheid als er een CLI is

De projectauteurs hebben een duidelijk onderscheid gemaakt tussen het hulpmiddel en de instructie. Het command-line-hulpprogramma narrator-ai-cli voert low-level commando's uit: stuurt REST-verzoeken naar de server, bevraagt taakstatussen, downloadt mediabestanden. Dit is standaard tooling.

Repository narrator-ai-cli-skill is een verzameling gestructureerde Markdown-bestanden. Bestand SKILL.md samen met map references/ legt aan het taalmodel de volgorde uit waarin commando's moeten worden aangeroepen, welke parameters moeten worden doorgegeven en hoe fouten moeten worden afgehandeld.

De analogie is eenvoudig: de CLI is keukenapparatuur, terwijl de vaardigheid het kookboek is. Zonder het hulpprogramma kan de agent niets bewerken, en zonder de vaardigheidsbeschrijvingsbestanden begrijpt het model de logica van functieaanroepen niet.

Wat zit er in de catalogus en hoe werkt de pipeline

De vaardigheid bevat ingebedde links naar kant-en-klare bronnen en beslissingsregels. De modellen hebben toegang tot:

• Ongeveer 100 bronfilms en TV-series
• 146 achtergrondmuziektracks
• 63 stemmen voor dubbing en voice-over
• Meer dan 90 kant-en-klare visuele templates
• 18 API-foutcodes met hun afhandelingsalgoritmen

Het videocreatieproces splitst zich in twee paden: snel en standaard. Het snelle pad neemt een bestaand origineel voice-over-script uit de database. Het standaardpad start scriptgeneratie helemaal opnieuw, waarbij de toon wordt aangepast aan gebruikersverzoeken.

De workflow is logisch. Het model vraagt eerst limieten op en controleert het accounttegoed. Vervolgens selecteert het de film-ID en een geschikte stemtimbre uit de referentiecatalogus. Daarna begint scriptgeneratie en storyboarding. In de eindfase stuurt het hulpprogramma de videorenderingstaak, pollt periodiek de API voor status en retourneert de definitieve link.

Naast het assembleren van complete video's kan het systeem geïsoleerde taken uitvoeren: een stem klonen van een kort audiobron of spraaksynthese genereren uit willekeurige tekst.

Installatie en verbinden met populaire agents

Python 3.10 of nieuwer is vereist. Installeer eerst de command-line-client:

pip install "narrator-ai-cli @ git+https://github.com/NarratorAI-Studio/narrator-ai-cli.git"

Na installatie moet je de toegangssleutel instellen:

narrator-ai-cli config set app_key YOUR_API_KEY

De vaardigheidsbestanden zelf moeten worden gekloond naar de map die je AI-assistent monitort. De mappenstructuur mag niet worden gewijzigd, aangezien SKILL.md voortdurend catalogi binnen de map references/ raadpleegt.

Voor OpenClaw ziet het klooncommando er zo uit:

mkdir -p ~/.openclaw/skills
git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git ~/.openclaw/skills/narrator-ai-cli

Als je werkt in Windsurf of Claude Code, kloon je het project naar je werkmap:

mkdir -p .skills
git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git .skills/narrator-ai-cli

Cursor-gebruikers hoeven alleen de repository in de rules-map te plaatsen:

mkdir -p .cursor/rules
git clone https://github.com/NarratorAI-Studio/narrator-ai-cli-skill.git .cursor/rules/narrator-ai-cli

Om de resource-database of vaardigheidslogica bij te werken, navigeer je simpelweg naar de map en voer je een standaard git pull uit.

Hoe communicatie met de agent werkt

Na het laden van de vaardigheid begint de agent contextuele commando's te begrijpen. Je kunt op een natuurlijke manier communiceren zonder CLI-flags te hoeven onthouden.

Voorbeelden van werkzinnen:

• "Toon me welke films er in de database zitten"
• "Maak 3 korte reviews van actiefilms in een dynamische stijl"
• "Voice-over deze tekst met een stem uit de database met vrolijke achtergrondmuziek"

Tijdens de werking volgt het model strikte instructies uit SKILL.md. Voordat bijvoorbeeld een zware renderingstaak wordt gestart, moet de agent de operationele kosten controleren en om gebruikersbevestiging vragen als parameters de standaardlimieten overschrijden.

Nuances en valkuilen

Het project lijkt een interessant experiment in het integreren van CLI in het AI-agent-ecosysteem, maar er zijn kanttekeningen voor praktisch gebruik.

De belangrijkste uitdaging is het verkrijgen van een API-sleutel. De README vermeldt expliciet dat sleutels op aanvraag worden verstrekt via e-mail [email protected] of via de WeChat-messenger. Dit creëert een drempel voor snel testen.

Hier is een afbeelding met de contactgegevens van de auteurs uit de documentatie:

De catalogus van films en timbres is momenteel voornamelijk gericht op de Aziatische markt en populaire wereldwijde hits. Als je een videoreview van een zeldzame arthouse-film nodig hebt, zal deze niet in de kant-en-klare database zitten.

Voor wie is deze repository nuttig

De repository is niet alleen de moeite waard om te bestuderen voor videogeneratie. Allereerst is het een uitstekende referentie voor het correct formatteren van SKILL.md specificaties voor taalmodellen.

Als je je eigen agent ontwerpt en hem wilt leren werken met je CLI-hulpprogramma, dient narrator-ai-cli-skill als een kant-en-klare template. Het heeft goed ontwikkelde datatoewijzingstabellen, API-foutafhandelingsalgoritmen en cascaderende aanroepscenario's.

Voor content creators en ontwikkelaars van mediaservices is dit een kant-en-klaar bouwblok dat het mogelijk maakt om routinematige korte videobewerking te delegeren aan neurale netwerken.