Napster Omniagent API Skills
Napster/omniagent-api-skills
Skills & plugin oficial para construir Omniagents com a API Napster
Ver no GitHubPacote oficial de skills para integrar a API Omniagent do Napster em agentes de código como Claude Code, Cursor e Codex. Fornece 12 skills especializadas para construir personas, agents, ferramentas e canais de deployment (web, áudio, phone), mais um servidor MCP com documentação atualizada em tempo real.
Instalação
npx convez-ai Napster/omniagent-api-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Integrar API Napster em aplicações web, audio e phone
- Gerar código de agentes e personas com boas práticas arquiteturais
- Acessar documentação atualizada via MCP em agentes de código
Veredito

Solução robusta e bem estruturada para desenvolvedores que trabalham com a plataforma Napster. O suporte multi-ferramenta (Claude Code, Cursor, Codex) e a integração com MCP a tornam versátil, embora exija familiaridade com a API Napster e ambiente Node 18+.
README
A tradução para o português deste README ainda está na fila.
Napster Omniagent API — Skills
The official Claude Code plugin and Agent Skills package for the Napster Omniagent API. It gives an AI coding agent a focused skill for every API concept — personas, agents, tools, knowledge, and every deployment channel (web, audio, phone) — plus a framework-agnostic default panel the skill adapts to your stack, and an optional local token server for prototyping. The skills are grounded in the live documentation through the bundled Napster docs MCP server, so they stay current instead of drifting from training data.
Where it runs: the 12 skills (and the bundled MCP docs server) work in any tool that follows the open Agent Skills spec — Claude Code, Cursor, Codex, OpenCode, and others — installed via npx skills add napster/omniagent-api-skills. The guided /omniagent-quickstart wizard is a Claude Code slash command, so the wizard itself is Claude-Code-only; the skills it orchestrates run anywhere.
After install, start here
- In Claude Code, new to the API? Run the wizard:
/napster-omniagent-api:omniagent-quickstart. It walks you from API key to a deployed Omniagent on the channel(s) you pick. (Slash commands are a Claude Code feature — see the natural-language path below in other tools.) - In any tool, already know what you want? Just say it in plain language — "create a persona", "embed the agent in my React app", "set up phone calls", "my mic isn't working" — and the matching skill fires automatically.
Prerequisites
- A Napster developer account and an API key — see
setup-api-key. - Node 18+ (the optional local token server uses native
fetchand has zero dependencies). - A project to build into. The skills detect your framework or fall back to plain HTML.
AI coding agent support
Napster provides three layers of support for AI coding agents — an MCP server for documentation access, agent skills for architectural guidance, and a Claude plugin that bundles everything together. Use one or all three depending on your tool.
| Layer | What it is | Best for |
|---|---|---|
| MCP server | Free docs server for any MCP-compatible tool | Giving your agent live access to the docs |
| Agent skills | Architectural guidance and best practices | Letting your agent generate Omniagent code that follows best practices |
| Claude plugin | All-in-one plugin with quickstart wizard | The fullest experience in Claude Code or Claude chat |
MCP server
For coding agents that support the Model Context Protocol, Napster provides a free MCP server with tools for browsing and searching the documentation site. This gives your coding agent direct access to API references, guides, and examples without leaving the editor.
The MCP endpoint is https://developers.napster.com/mcp. Add it to your tool:
Claude Code
claude mcp add napster-docs --transport http https://developers.napster.com/mcp
Cursor
Add to .cursor/mcp.json in your project (or ~/.cursor/mcp.json for all projects):
{
"mcpServers": {
"napster-docs": {
"url": "https://developers.napster.com/mcp"
}
}
}
VS Code / Copilot (agent mode)
Add to .vscode/mcp.json in your workspace (or in your user settings):
{
"servers": {
"napster-docs": {
"type": "http",
"url": "https://developers.napster.com/mcp"
}
}
}
Codex
Add to ~/.codex/config.toml:
[mcp_servers.napster-docs]
url = "https://developers.napster.com/mcp"
Any other MCP-capable tool
Use your tool's standard MCP HTTP server configuration with:
| Field | Value |
|---|---|
| Name | napster-docs |
| Transport | http |
| URL | https://developers.napster.com/mcp |
Agent skills
Napster publishes open-source skills for coding agents that provide architectural guidance and best practices for building Omniagents — covering workflow design, channel configuration, tool integration, and deployment patterns. Combined with the MCP server, skills give your coding agent deep expertise about building with the Omniagent API so it can look up the docs, understand the architecture, and generate code that follows best practices.
Works in any tool that follows the open Agent Skills spec — Claude Code, Cursor, Codex, OpenCode, and others. In your project root:
npx skills add napster/omniagent-api-skills
Claude plugin
The Napster plugin bundles the MCP server and agent skills into a single package with an interactive /omniagent-quickstart wizard. Setup depends on which Claude environment you use.
Claude Code (CLI and IDE extensions)
Recommended. The CLI always pulls the latest skills and MCP server.
Step 1 — add the Napster marketplace:
/plugin marketplace add https://github.com/Napster/omniagent-api-skills.git
Step 2 — install the plugin:
/plugin install napster-omniagent-api@napster
To update to the latest version later:
/plugin marketplace update napster
Third-party marketplaces don't auto-update by default in Claude Code, so this manual refresh is how you'll get new skills, MCP changes, or bug fixes. (You can enable auto-update per marketplace via /plugin → Marketplaces → Enable auto-update if you prefer that workflow.)
After install you'll have /omniagent-quickstart and all 12 skills auto-triggering on natural language.
Claude (browser and desktop chat product)
For the browser version (claude.ai) and the Mac/Windows desktop app, you need to download the plugin manually first.
Step 1 — Download the plugin. Go to the Napster Omniagent API Skills repo, click the green Code button, and select Download ZIP. Save the file to your machine.
Skills installed from a ZIP won't update automatically. If we publish new skills, you'll need to re-download and re-upload. The Claude Code CLI handles updates for you.
Step 2 — Install the plugin.
In Claude (browser, claude.ai):
- In the left sidebar, click Customize.
- Click the + button to add a plugin, then choose Create plugin → Upload plugin.
- Select the ZIP file you downloaded in Step 1.
- Once uploaded, click the plugin in the left sidebar — the skills install automatically.
- Open the Connectors tab — you'll see Napster Docs (the MCP server). Click Install.
In Claude (desktop, Mac/Windows): same flow as above through the desktop app's Customize UI.
What you get
Once installed, the plugin gives your coding agent:
- Access to the full Omniagent API documentation via MCP
- Architectural guidance for building Omniagents
- A quickstart wizard that walks you through creating your first agent
Manual install (any tool, or if none of the above fits)
git clone https://github.com/Napster/omniagent-api-skills
Then point your tool at the cloned folder — for example, with the Claude Code CLI: claude --plugin-dir ./omniagent-api-skills. For other tools, check their docs for "load skills from a local folder."
What's inside
omniagent-api-skills/
├── .claude-plugin/plugin.json Plugin manifest (only file in this folder)
├── .mcp.json Napster docs MCP server (source of truth for API details)
├── .cursor/ .vscode/ MCP config for cross-tool use
├── commands/
│ └── omniagent-quickstart.md The guided end-to-end wizard
├── skills/
│ ├── setup-api-key/ Get an API key, store it as NAPSTER_API_KEY
│ ├── create-persona/ Create the appearance + personality entity
│ ├── create-agent/ Assemble a deployable Omniagent from a persona
│ ├── manage-agents/ List, update, delete Omniagents
│ ├── create-tool/ Define a function the agent can call mid-conversation
│ ├── add-knowledge/ Upload files, define FAQs, attach to an agent
│ ├── deploy-webrtc/ Web channel: browser audio + video via the Web SDK
│ ├── deploy-websocket/ Audio-only channel for headless/custom clients
│ ├── deploy-phone/ Phone channel — a number the agent answers (VoIP or SIP)
│ ├── session-runtime/ Per-session config, server events, client commands
│ ├── monitor-sessions/ List sessions, pull transcripts
│ └── troubleshoot-omniagent/ The pitfall index, organized by area
└── assets/
├── omniagent-ui.css Canonical panel styles (framework-agnostic)
├── omniagent-panel-reference.html Canonical panel structure (header + mount + footer)
│ (brand mark is inlined as SVG in the panel HTML)
└── local-token-server/ Optional prototyping scaffold (not for production)
Frameworks supported
The deploy skills detect React, Next.js, Vue, Nuxt, Svelte, Remix, and plain HTML, and fall back to plain HTML when the stack can't be determined. There are no per-framework component files to maintain: the default panel is one CSS file plus one structural HTML reference (assets/omniagent-panel-reference.html), and the skill replicates that structure into your framework's idiom (JSX, Vue template, Svelte markup, or inline HTML).
Default UI and the "Powered by Napster" footer
The default panel includes a small Powered by Napster footer that links to the developer docs. It is on by default on every Omniagent surface. The skills will not remove it unless you explicitly ask — for example, when an enterprise deployment has its own brand chrome.
Conceptual map
| Term | What it is | API resource |
|---|---|---|
| Omniagent | The deployed agent — one identity across every channel | /public/agents |
| Persona | Appearance + personality (voice is set on the agent) | /public/companions |
| Function | A callable tool the agent invokes mid-conversation | /public/functions |
| Knowledge base / FAQ | Documents and curated Q&A the agent grounds answers in | /public/knowledge-bases, /public/faqs |
| Channel | The surface a session runs on: WebRTC, WebSocket, Phone (VoIP or SIP) | per-session connections + /channels/{type} |
| Session | One conversation, with its transcript and config | /public/sessions |