Skills para agentes

Skills para agentes são arquivos de instruções prontos que ensinam agentes de programação, como o Claude Code e o Cursor, a criar com o Nodaro. Uma skill diz ao agente como instalar e autenticar o SDK, quais padrões seguir e quais erros evitar, para uma tarefa: integrar o SDK ou criar um app OAuth. Carregue uma skill uma vez e depois peça ao agente o que você quer construir.

O que está disponível

Instalar o plugin do Claude Code

No Claude Code, execute:

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

Uma única instalação adiciona duas coisas:

• A skill do SDK do Nodaro: configuração do cliente, geração assíncrona, descoberta de modelos e de créditos, exibição do progresso, tratamento de erros e OAuth. O Claude a carrega quando você menciona o Nodaro, @nodaro/sdk, @nodaro/cli ou uma integração com o app.nodaro.ai.
• A conexão MCP hospedada com https://mcp.nodaro.ai/mcp, para que o Claude também possa usar o Nodaro diretamente. Veja Agentes de IA (MCP).

Adicionar um arquivo de skill ao seu projeto

Os dois arquivos de skill ficam na pasta docs/skills do repositório público. Cada arquivo começa com um frontmatter YAML: um name e uma description que diz ao agente quando carregar a skill. Em seguida vêm as instruções em Markdown.

O que a skill do SDK cobre

A using-nodaro-sdk é ativada quando um agente integra o @nodaro/sdk a uma aplicação: automação no servidor, um app de navegador em uma instância do Nodaro ou um app OAuth de terceiros. Ela cobre:

• Configuração e os três modos de autenticação: StaticTokenAuth no servidor, com um token de API pessoal ou de acesso OAuth; supabaseAuth em um app de navegador na sua própria instância; e CallbackAuth para a sua lógica de token.
• Os recursos do cliente, como workflows, nodes, jobs, executions, characters, apps, oauth e credits.
• Os erros tipados: UnauthorizedError, ForbiddenError com o seu missingScope, InsufficientCreditsError com required e available, RateLimitedError e o NodaroError base.
• Receitas: executar um workflow e consultá-lo periodicamente, descobrir os nós disponíveis e executar um único nó com runAndWait.
• Esforço de raciocínio para os nós que usam um modelo de linguagem, além de fetch e timeout personalizados.
• Quando não usar o SDK: endpoints com streaming de tokens, como a resposta em streaming do nó Prompt, que não têm método no SDK.

O que a skill de OAuth cobre

A building-nodaro-oauth-app é ativada quando um agente implementa OAuth com uma instância do Nodaro. Ela cobre quando preferir OAuth a um token de API pessoal, registro do app, escopos, URL de redirecionamento, troca do código no servidor, armazenamento e revogação de tokens, erros comuns e um checklist de segurança. A referência completa é Apps OAuth.

Colar o guia do SDK para agentes

O guia do SDK para agentes (SDK agent primer) é um resumo de uma página do SDK para agentes de programação. Ele está no README do pacote @nodaro/sdk e em um arquivo de texto simples que você pode copiar de um terminal:

curl -s https://raw.githubusercontent.com/nodaroai/app.nodaro.ai/main/docs/sdk-agent-primer.txt | pbcopy          # macOS
curl -s https://raw.githubusercontent.com/nodaroai/app.nodaro.ai/main/docs/sdk-agent-primer.txt | xclip -sel clip  # Linux

Cole o guia em qualquer agente e depois peça o que você quer construir. Ele ensina ao agente:

• Configuração: npm install @nodaro/sdk e um token de Configurações › Tokens de API na variável de ambiente NODARO_ACCESS_TOKEN, nunca escrito no código.
• O padrão principal: toda geração é assíncrona, e client.nodes.runAndWait envia, consulta periodicamente e devolve a saída.
• Escolha do modelo: omita provider para usar o modelo padrão da plataforma, ou monte um seletor de modelos com client.nodes.get(type) e client.credits.modelCosts().
• Regras de interface: mostre cada resultado intermediário assim que ele existir, mostre o progresso em tempo real com onProgress e deixe o usuário cancelar com um AbortSignal.
• A parte de voz e áudio, incluindo a troca de voz com vários falantes e o fluxo interativo de análise, troca de voz e exportação.
• Créditos: as gerações custam créditos, então trate InsufficientCreditsError.

O padrão principal que ele ensina:

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

Dar a documentação aos agentes em Markdown

• Toda página está disponível em Markdown. Adicione .md à URL dela, por exemplo https://nodaro.ai/docs/developers/oauth.md.
• https://nodaro.ai/llms.txt lista todas as páginas da documentação com o resumo de uma linha de cada uma.
• https://nodaro.ai/llms-full.txt contém a documentação completa em um único arquivo.

Para criar uma interface personalizada para um app publicado com um gerador de código de IA, dê a ele o Markdown de Incorporar um miniapp.

Skills ou MCP

O plugin do Claude Code oferece os dois. Veja Conectar um cliente para adicionar o servidor MCP a outros agentes.

Escrever a sua própria skill

Uma boa skill para trabalhar com o Nodaro segue quatro regras:

• Um gatilho focado. Escreva a description para que a skill seja carregada na tarefa dela, e não em trabalhos sem relação.
• Conteúdo prático. Dê ao agente passos concretos e código, não só contexto.
• Fontes para conferir. Inclua links para as páginas da documentação em que a skill se baseia, para que o agente possa verificar os detalhes.
• Em sincronia com a documentação. Atualize a skill quando as páginas em que ela se baseia mudarem.