Agent skill

API Scripts

by nodetool-ai in nodetool-ai/nodetool

Call nodetool.scripts from a code action: create a voice script, add speakers with voices and spoken lines, voice the lines as audio takes, and assemble the takes into a voiceover timeline with word…

AGPL-3.0Auto-check passedMedia & Creative

Install API Scripts

skills CLI
$ npx skills add nodetool-ai/nodetool --skill api-scripts -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install nodetool-ai/nodetool api-scripts --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/nodetool-ai/nodetool.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/system-skills/api-scripts .claude/skills/api-scripts && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
api-scripts
GitHub stars
556
Token cost
~1k tokens
SKILL.md length
458 words
Files
1
Skills in repo
127
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Call nodetool.scripts from a code action: create a voice script, add speakers with voices and spoken lines, voice the lines as audio takes, and assemble the takes into a voiceover timeline with word…

  • Tasks that involve Text to speech and voice
  • SKILL.md covers Ops and voice
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

API Scripts is an agent skill from nodetool-ai/nodetool. Call nodetool.scripts from a code action: create a voice script, add speakers with voices and spoken lines, voice the lines as audio takes, and assemble the takes into a voiceover timeline with word timings. Load before the first call into nodetool.scripts.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering Text to speech and voice. The repository describes itself as: Agent-first Creative Workspace. The licence is AGPL-3.0.

When your agent uses it

  • Tasks that involve Text to speech and voice

Example prompts

  • “/api-scripts”

What it can do on your machine

Read from SKILL.md and the folder at commit 515bd28. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are javascript).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

API Scripts loads about 1k tokens when it runs. Until then it costs about 67 tokens; SKILL.md has 458 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~67
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from nodetool-ai/nodetool at commit 515bd28, republished under its AGPL-3.0 licence (© nodetool-ai). 458 words, ~1,004 tokens.

Download SKILL.mdSave it as .claude/skills/api-scripts/SKILL.md (or your agent's skills folder).
name
api-scripts
description
Call nodetool.scripts from a code action: create a voice script, add speakers with voices and spoken lines, voice the lines as audio takes, and assemble the takes into a voiceover timeline with word timings. Load before the first call into nodetool.scripts.

nodetool.scripts

A script (a voice script) is a cast of speakers, each with a voice, and the lines they speak in reading order. Voicing a line makes an audio take. Assembling lays the takes into a timeline. A JavaScript script is a different document (nodetool-js-scripting). A video timed to a written voiceover is script-video.

CallDoesAnswers
list({limit})Lists scripts, newest first, with cast size, line count, voiced count and the timeline it was assembled into.Script rows
create(name, {project_id, id})Creates an empty script. An existing id is returned as it is, so a retry makes no copy.{script_id, …}
get(id)Reads the cast and every line with its id, index, speaker, text, direction, pause, effective voice and voicing status.The script
edit(id, ops)Applies ops in order and saves. An open editor picks the change up live.The result of each op
voice(id, opts)Calls the TTS provider for the lines.The takes it made
assembleTimeline(id, {name, fps})Lays the voiced takes end to end into a timeline.The timeline id, and the lines it skipped

Line status is draft (never voiced), stale (the text or voice changed since the take), voiced or no_voice (the speaker has no voice).

Ops

A line target is its id, its 0-based index in the whole script, or its exact text. A speaker target is its id or name. An argument an op does not take is refused.

OpArguments
set_setupstage?, brief?, format?, length_seconds?, pace?, language?
add_speakername, color?, provider?, model?, voice?, entityId?
set_speakertarget, name?, color?, entityId? — renames or recolours a speaker
set_speaker_voicetarget, provider, model, voice, settings?
remove_speakertarget
add_sectiontitle?
add_linetext, speaker?, section?, direction?, pause_after_ms?, index?
set_line_texttarget, text
set_line_speakertarget, speaker — the op that gives a line its speaker
remove_linetarget
  • format is voiceover, dialogue, interview, ad-read or tutorial.
  • entityId makes the speaker a cast character from the entity library, so storyboard renders can use it.
  • A rewritten line keeps its takes as stale, so the next voice() records exactly those again.
Show full SKILL.md (123 more words)Show less

voice

  • Omit targets to voice every line that is unvoiced or stale. A whole script is one call.
  • targets takes line ids, indexes or exact texts.
  • Each line uses its own voice, else its speaker's. provider, model and voice together override every line. Pick the model with nodetool.models.pick("text_to_speech").
  • speed, concurrency (default 3, max 8).
  • Word timings are transcribed for captions (transcribe, default true; asr_provider and asr_model default to openai and whisper-1).
  • Earlier takes are kept, and the new take becomes current.
js
const { script_id: id } = await nodetool.scripts.create("Launch VO");
await nodetool.scripts.edit(id, [
  { op: "add_speaker", name: "Narrator" },
  { op: "set_speaker_voice", target: "Narrator", provider, model, voice },
  { op: "add_line", text: "Meet the lamp that listens.", speaker: "Narrator" }
]);
await nodetool.scripts.voice(id);
const cut = await nodetool.scripts.assembleTimeline(id);

Each assembled clip carries its word timings, the speaker label and a link to its line, so a re-voiced line can round-trip into the cut. Running the assembly again rebuilds the same timeline in place. Validate it with nodetool.timelines.validate before a render.

© nodetool-ai, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in packages/system-skills/api-scripts of nodetool-ai/nodetool.

Open the folder on GitHubat commit 515bd28

Compare with similar skills

API Scripts next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

API Scripts compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
API Scripts this skillnodetool-ai/nodetool556—~1kAutomated safety check: PassAGPL-3.0
MoneyPrinterTurbo Video Generatorharry0703/MoneyPrinterTurbo129k—~2.1kAutomated safety check: WarnMIT
HyperFrames Media Useheygen-com/hyperframes59k—~2.4kAutomated safety check: PassApache-2.0
Videodbaffaan-m/ECC275k3 repos~3.5kAutomated safety check: NotesMIT
Musictadaspetra/loop2963 repos~827Automated safety check: PassMIT
Openspec OnboardSAP/e-mobility-charging-stations-simulator22725 repos~3.5kAutomated safety check: PassMIT

Similar skills

  • MoneyPrinterTurbo Video Generator

    harry0703/MoneyPrinterTurbo

    Installs and runs MoneyPrinterTurbo to turn a topic or script into a finished short video with voice-over, subtitles, stock footage and music.

    129k GitHub stars~2.1k tokensUpdated today
    Media & CreativeAuto-check: warnings
  • HyperFrames Media Use

    heygen-com/hyperframes

    Finds, generates and edits media for HyperFrames video projects: music, sound effects, images, icons, logos, voiceovers, captions and color grades.

    59k GitHub stars~2.4k tokensUpdated today
    Media & CreativeAuto-check passed
  • Videodb

    affaan-m/ECC

    Ingest, index, search, edit, and monitor video and audio with the VideoDB Python SDK — upload from files, URLs, or RTSP feeds, build spoken and scene indexes with timestamped search and playable…

    275k GitHub starsUsed in 3 repos~3.5k tokens
    Media & CreativeAuto-check: notes
  • Music

    tadaspetra/loop

    Generate music using ElevenLabs Music API. An agent skill from tadaspetra/loop.

    296 GitHub starsUsed in 3 repos~827 tokens
    Media & CreativeAuto-check passed
  • Openspec Onboard

    SAP/e-mobility-charging-stations-simulator

    Official

    Guided onboarding for OpenSpec - walk through a complete workflow cycle with narration and real codebase work.

    227 GitHub starsUsed in 25 repos~3.5k tokens
    Media & CreativeAuto-check passed
  • Blog Audio

    AgriciDaniel/claude-blog

    Generate audio narration of blog posts using Google Gemini TTS.

    2.3k GitHub starsUsed in 1 repo~2.2k tokens
    Media & CreativeAuto-check: notes

More from nodetool-ai/nodetool

All 127 skills in this repo
  • Beat Sync Editing

    nodetool-ai/nodetool

    Cut a NodeTool timeline to music and shape its pacing — detect the beat grid, place cuts on phrases, pick a cut type, build speed ramps with time remap, and give the piece an arc.

    556 GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • Caption Titles

    nodetool-ai/nodetool

    Add and animate a consistent text layer on an existing NodeTool timeline.

    556 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Color Motion

    nodetool-ai/nodetool

    Choose and animate colour on a NodeTool timeline, including shape and text gradients, colour grades, 3D LUTs, and dither.

    556 GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Commercial Beat Sheet

    nodetool-ai/nodetool

    Write a shootable, precisely timed commercial beat sheet and store it as a NodeTool storyboard, with a consistent entity roster behind every shot.

    556 GitHub stars~4.6k tokensUpdated today
    Auto-check passed
  • Elevenlabs Audio Prompting

    nodetool-ai/nodetool

    Direct ElevenLabs speech, dialogue, sound effects and music — the bracketed audio tags v3 acts on and why the voice decides whether a tag lands, stability as the delivery dial, punctuation instead…

    556 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Frame Composition

    nodetool-ai/nodetool

    Stage the frame on a NodeTool timeline — grids, focal placement, safe areas per aspect ratio, depth layers and parallax, camera moves, and where elements enter and leave.

    556 GitHub stars~3.5k tokensUpdated today
    Auto-check passed

Questions about API Scripts

What does API Scripts do?

Call nodetool.scripts from a code action: create a voice script, add speakers with voices and spoken lines, voice the lines as audio takes, and assemble the takes into a voiceover timeline with word…. API Scripts is an agent skill from nodetool-ai/nodetool.scripts from a code action: create a voice script, add speakers with voices and spoken lines, voice the lines as audio takes, and assemble the takes into a voiceover timeline with word timings.

When should I use API Scripts?

API Scripts fits situations like: tasks that involve Text to speech and voice.

How do I install API Scripts in Claude Code?

Run `npx skills add nodetool-ai/nodetool --skill api-scripts -a claude-code`. Or copy the skill folder (packages/system-skills/api-scripts in nodetool-ai/nodetool) into .claude/skills/api-scripts in your project. Claude Code loads it when a task matches its description.

How do I install API Scripts in Codex?

Run `npx skills add nodetool-ai/nodetool --skill api-scripts -a codex`. Or copy the skill folder (packages/system-skills/api-scripts in nodetool-ai/nodetool) into .agents/skills/api-scripts in your project. Codex loads it when a task matches its description.

Can I use API Scripts in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add nodetool-ai/nodetool --skill api-scripts -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/api-scripts, .gemini/skills/api-scripts, .github/skills/api-scripts and .opencode/skills/api-scripts in your project.

What does API Scripts need to run?

SKILL.md names no scripts, command-line tools or credentials: API Scripts is instructions for the agent only.

Does API Scripts access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is API Scripts safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does API Scripts use?

API Scripts is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does API Scripts use?

About 1k tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to API Scripts?

Skills that share tags, products or a category with API Scripts: MoneyPrinterTurbo Video Generator (harry0703/MoneyPrinterTurbo, 129k stars), HyperFrames Media Use (heygen-com/hyperframes, 59k stars), Videodb (affaan-m/ECC, 275k stars) and Music (tadaspetra/loop, 296 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains API Scripts?

nodetool-ai (a GitHub organization) maintains it in nodetool-ai/nodetool, which has 556 GitHub stars. The repository holds 127 skills in this directory. The repository was last updated on October 8, 2026.

Source: nodetool-ai/nodetool on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.