Agent skill

API Models

by nodetool-ai in nodetool-ai/nodetool

Call nodetool.models from a code action: pick the best configured model for a capability, search for a model the user named, browse a provider's catalog, set a node's model property, or make one…

AGPL-3.0Auto-check passedMedia & Creative

Install API Models

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

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

GitHub CLI
$ gh skill install nodetool-ai/nodetool api-models --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-models .claude/skills/api-models && 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-models
GitHub stars
554
Token cost
~976 tokens
SKILL.md length
388 words
Files
1
Skills in repo
130
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Call nodetool.models from a code action: pick the best configured model for a capability, search for a model the user named, browse a provider's catalog, set a node's model property, or make one…

  • Media & Creative work in your project
  • SKILL.md covers Calls, What a result carries, Rules and Examples
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

API Models is an agent skill from nodetool-ai/nodetool. Call nodetool.models from a code action: pick the best configured model for a capability, search for a model the user named, browse a provider's catalog, set a node's model property, or make one language-model call. Load before the first call into nodetool.models.

Its SKILL.md is about 980 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. The repository describes itself as: Agent-first Creative Workspace. The licence is AGPL-3.0.

When your agent uses it

  • Media & Creative work in your project

Example prompts

  • “s catalog, set a node”
  • “/api-models”

What it can do on your machine

Read from SKILL.md and the folder at commit f99c652. 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 Models loads about 976 tokens when it runs. Until then it costs about 69 tokens; SKILL.md has 388 words of instructions outside code blocks.

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

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 f99c652, republished under its AGPL-3.0 licence (© nodetool-ai). 388 words, ~976 tokens.

Download SKILL.mdSave it as .claude/skills/api-models/SKILL.md (or your agent's skills folder).
name
api-models
description
Call nodetool.models from a code action: pick the best configured model for a capability, search for a model the user named, browse a provider's catalog, set a node's model property, or make one language-model call. Load before the first call into nodetool.models.

nodetool.models

Model discovery for this install. It knows which providers have credentials and which local models are downloaded. Never guess a model id: pick one here, then pass it on. Credentials and provider setup are nodetool-model-provider-config.

Calls

CallDoesAnswers
pick(capability, {query, provider_hint, model_hint, prefer_local})Resolves ONE model.The top result: {provider, model_id, ref, …}
find(capability, {query, task, provider_hint, model_hint, prefer_local, limit})Ranks candidates. limit defaults to 5.{results, ref, note?, query_matched?}
list({provider, model_type, downloaded_only, limit})Browses every configured model.{results}
forProvider(provider)Lists one provider's language models.The provider catalog
generate(prompt, model, {system, images, max_tokens, temperature})One language-model call, with optional images. No asset is made.{provider, model, text}

capability is one of text_to_image, image_to_image, segment_image, text_to_video, image_to_video, reference_to_video, text_to_speech, text_to_music, audio_to_audio, automatic_speech_recognition, generate_embedding and generate_message.

model_type for list is one of language, image, video, tts, music, audio_to_audio, asr and embedding.

What a result carries

  • provider and model_id — the route. Every nodetool.media.* call takes the whole result, {provider, model_id}, or a "provider/model_id" string.
  • ref — the typed value {type, provider, id, name}. Assign it verbatim to a node's *_model property. The flat model_id field does not fit that property.
  • For ranked media models: canonical, ranked_task, rank and of, and alternate_routes for other providers that serve the same model. One model is one row, not one row for each route.
  • prompting_skill — the name of the shipped guide for that model line. Load it with load_skill before you write the prompt.
Show full SKILL.md (151 more words)Show less

Rules

  • pick with no options is the good default. For image, video, speech and music, the order comes from a quality leaderboard for the task. Do not shop around.
  • When the user named a model, search in the same call: pick("text_to_image", {query: "flux schnell"}). query is free text over the model id and name. All words must appear, and separators do not matter.
  • pick throws when no configured provider offers the capability, and when a query matches nothing. It never answers with an unrelated model. Report the miss or call find to see what is configured.
  • task is a hint against the supported tasks of a model. It is not a search box. Use query to search by name.
  • A judge for nodetool.media.critique, compare, scoreAdherence and understandVideo is a chat model that reads images or video: pick("generate_message", {query: "gemini"}), for example. It is not the model that made the picture.

Examples

js
// The best image model, straight into a generation.
const model = await nodetool.models.pick("text_to_image");
const shot = await nodetool.media.generateImage("a red fox in snow", model);

// A node property wants the typed ref.
const tts = await nodetool.models.pick("text_to_speech");
wf.node("speech_1").set({ model: tts.ref });

// One text call with an image.
const llm = await nodetool.models.pick("generate_message");
const { text } = await nodetool.models.generate(
  "Name the dominant colour in one word.", llm, { images: [shot.asset_uri] }
);

© 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-models of nodetool-ai/nodetool.

Open the folder on GitHubat commit f99c652

Compare with similar skills

API Models 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 Models compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
API Models this skillnodetool-ai/nodetool554—~976Automated safety check: PassAGPL-3.0
Video Scriptitwanger/toBeBetterJavaer18k—~2.2kAutomated safety check: PassNone
Benchddalcu/mlx-serve1.8k1 repos~1.1kAutomated safety check: PassCustom licence
PR Chartsddalcu/mlx-serve1.8k—~594Automated safety check: PassCustom licence
Flux 3 Keyframes Continuationblack-forest-labs/skills1251 repos~827Automated safety check: PassMIT
Agnes AI Supportlj1270998580-crypto/Agnes-help-skill304—~14kAutomated safety check: NotesNone

Similar skills

  • Video Script

    itwanger/toBeBetterJavaer

    口播稿,适用于 AI 技术科普、Agent/Skill/RAG、LLM 等底层原理讲解,以及面试题拆解、工具实测、热点普及。支持两种用法:给定主题从零产出口播稿、对已有口播稿进行优化。触发关键词包括:口播、口播稿、video script。

    18k GitHub stars~2.2k tokensUpdated today
    Media & CreativeAuto-check passed
  • Bench

    ddalcu/mlx-serve

    mlx-serve benchmarking methodology — bench.sh/llmprobe usage, comparison-trap rules (same-methodology cells only, spec-decode variance, thermal lies, engine naming), perf-claim etiquette.

    1.8k GitHub starsUsed in 1 repo~1.1k tokens
    Media & CreativeAuto-check passed
  • PR Charts

    ddalcu/mlx-serve

    Turn llmprobe reports into the charts a perf PR embeds (one line per arm across context size, every point labelled, machine and model in the caption) and host them so the PR body renders them.

    1.8k GitHub stars~594 tokensUpdated today
    Media & CreativeAuto-check passed
  • Flux 3 Keyframes Continuation

    black-forest-labs/skills

    A skill your agent uses when a FLUX 3 video must be built from supplied images or video.

    125 GitHub starsUsed in 1 repo~827 tokens
    Media & CreativeAuto-check passed
  • Agnes AI Support

    lj1270998580-crypto/Agnes-help-skill

    Agnes AI API 接入支持与问题排查 Skill。帮助新用户完成 Agnes AI API 的接入配置, 诊断和解决接入过程中遇到的认证、参数、响应、图像生成、视频生成等各类问题。

    304 GitHub stars~14k tokensUpdated 14 days ago
    Media & CreativeAuto-check: notes
  • Dotty Av Test

    BrettKinny/dotty-stackchan

    Run local black-box voice tests against the physical Dotty robot by playing a TTS prompt through the workstation speakers while the C920 records video and room audio.

    113 GitHub stars~866 tokensUpdated 2 days ago
    Media & CreativeAuto-check: notes

More from nodetool-ai/nodetool

All 130 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.

    554 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.

    554 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.

    554 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.

    554 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…

    554 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.

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

Questions about API Models

What does API Models do?

Call nodetool.models from a code action: pick the best configured model for a capability, search for a model the user named, browse a provider's catalog, set a node's model property, or make one…. API Models is an agent skill from nodetool-ai/nodetool.models from a code action: pick the best configured model for a capability, search for a model the user named, browse a provider's catalog, set a node's model property, or make one language-model call.

When should I use API Models?

API Models fits situations like: media & Creative work in your project.

How do I install API Models in Claude Code?

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

How do I install API Models in Codex?

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

Can I use API Models 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-models -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-models, .gemini/skills/api-models, .github/skills/api-models and .opencode/skills/api-models in your project.

What does API Models need to run?

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

Does API Models 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 Models 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 Models use?

API Models 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 Models use?

About 976 tokens (SKILL.md is roughly 3.9k 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 Models?

Skills that share tags, products or a category with API Models: Video Script (itwanger/toBeBetterJavaer, 18k stars), Bench (ddalcu/mlx-serve, 1.8k stars), PR Charts (ddalcu/mlx-serve, 1.8k stars) and Flux 3 Keyframes Continuation (black-forest-labs/skills, 125 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains API Models?

nodetool-ai (a GitHub organization) maintains it in nodetool-ai/nodetool, which has 554 GitHub stars. The repository holds 130 skills in this directory. The repository was last updated on October 7, 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.