Agent skills

Agent skills are ready-made instruction files that teach coding agents, such as Claude Code and Cursor, to build on Nodaro. A skill tells the agent how to install and authenticate the SDK, which patterns to follow and which mistakes to avoid, for one task: integrating the SDK, or building an OAuth app. Load a skill once, then ask the agent for what you want built.

What is available

Install the Claude Code plugin

In Claude Code, run:

/plugin marketplace add nodaroai/app.nodaro.ai
/plugin install nodaro

One install adds two things:

• The Nodaro SDK skill: client setup, asynchronous generation, model and credit discovery, progress display, error handling and OAuth. Claude loads it when you mention Nodaro, @nodaro/sdk, @nodaro/cli or an integration with app.nodaro.ai.
• The hosted MCP connection to https://mcp.nodaro.ai/mcp, so Claude can also use Nodaro directly. See AI Agents (MCP).

Add a skill file to your project

The two skill files live in the docs/skills folder of the public repository. Each file starts with YAML frontmatter: a name, and a description that tells the agent when to load the skill. Markdown instructions follow.

What the SDK skill covers

using-nodaro-sdk activates when an agent integrates @nodaro/sdk into an application: server-side automation, a browser app on a Nodaro instance, or a third-party OAuth app. It covers:

• Setup and the three auth modes: StaticTokenAuth on a server, with a personal API token or an OAuth access token; supabaseAuth in a browser app on your own instance; and CallbackAuth for your own token logic.
• The resources of the client, such as workflows, nodes, jobs, executions, characters, apps, oauth and credits.
• The typed errors: UnauthorizedError, ForbiddenError with its missingScope, InsufficientCreditsError with required and available, RateLimitedError, and the base NodaroError.
• Recipes: run a workflow and poll it, discover the available nodes, and run a single node with runAndWait.
• Reasoning effort for the nodes that use a language model, and a custom fetch and timeout.
• When not to use the SDK: streaming endpoints, which it does not cover.

What the OAuth skill covers

building-nodaro-oauth-app activates when an agent implements OAuth against a Nodaro instance. It covers when OAuth is the right choice over a personal API token, the app registration, the scopes, the redirect URL, the server-side code exchange, token storage, revocation, the common errors and a security checklist. The full reference is OAuth apps.

Paste the SDK agent primer

The SDK agent primer is a one-page brief of the SDK for coding agents. Its canonical copy is in the README of the @nodaro/sdk package. Paste it into any agent, then ask for what you want built. It teaches the agent:

• Setup: npm install @nodaro/sdk, and a token from Settings › API in the NODARO_ACCESS_TOKEN environment variable, never written into the code.
• The core pattern: all generation is asynchronous, and client.nodes.runAndWait submits, polls and returns the output.
• Model choice: omit provider to use the platform's default model, or build a model picker from client.nodes.get(type) and client.credits.modelCosts().
• Interface rules: show each intermediate result as soon as it exists, show live progress with onProgress, and let the user cancel with an AbortSignal.
• The voice and audio surface, including multi-speaker recasting and the interactive analyze, recast and export flow.
• Credits: generations cost credits, so catch InsufficientCreditsError.

The core pattern it teaches:

import { createClient, StaticTokenAuth } from "@nodaro/sdk"

const client = createClient({
  baseUrl: "https://app.nodaro.ai",
  auth: new StaticTokenAuth(process.env.NODARO_ACCESS_TOKEN!),
})

const img = await client.nodes.runAndWait("generate-image", {
  prompt: "...", provider: "nano-banana-2",
})
const vid = await client.nodes.runAndWait("generate-video", {
  prompt: "...", imageUrl: img.imageUrl,   // the image becomes the start frame
  provider: "seedance-2-fast", duration: 4,
})
// Outputs are on the resolved object: .imageUrl, .videoUrl, .audioUrl

Give agents the docs as Markdown

• Every page is available as Markdown. Add .md to its URL, for example https://nodaro.ai/docs/developers/oauth.md.
• https://nodaro.ai/llms.txt lists every docs page with its one-line summary.
• https://nodaro.ai/llms-full.txt holds the complete documentation in one file.

To build a custom interface for a published app with an AI code generator, give it the Markdown of Embed a MiniApp.

Skills or MCP

The Claude Code plugin gives you both. See Connect a client to add the MCP server to other agents.

Write your own skill

A good skill for Nodaro work follows four rules:

• A focused trigger. Write the description so the skill loads for its task, and not for unrelated work.
• Actionable content. Give the agent concrete steps and code, not only background.
• Sources to check. Link the docs pages the skill relies on, so the agent can verify details.
• In sync with the docs. Update the skill when the pages it relies on change.