rozenite-agent-sdk
Use Rozenite for Agents through `@rozenite/agent-sdk` in Node.js or TypeScript code. Trigger this skill when Codex needs to write or run scripts, wrappers, automations, benchmarks, or agent runtimes that call Rozenite programmatically instead of driving the `rozenite agent` CLI directly.
How do I install this agent skill?
npx skills add https://github.com/callstackincubator/rozenite --skill rozenite-agent-sdkIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The rozenite-agent-sdk skill enables agents to programmatically control applications using the Rozenite SDK. It provides comprehensive patterns for session management, tool discovery, and plugin interaction. The skill follows safe development practices by using scoped vendor packages and intended execution flows.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Rozenite Agent SDK
Use this skill when the user wants code-first access to Rozenite for Agents.
Read references/code-patterns.md for copy-pastable examples.
Rules
- Prefer throwaway Node ESM scripts that import
@rozenite/agent-sdk. - Default flow:
createAgentClient()->client.withSession(...)-> inspect or call tools -> exit. - Use
session.domains.list()as the source of truth for live built-in and runtime domains. - Use
session.tools.list({ domain })andsession.tools.getSchema({ domain, tool })only when you need live inspection or argument confirmation. - Prefer typed plugin SDK descriptors from any available official plugin
./sdkexport and call tools assession.tools.call(descriptor, args). - Fall back to
session.tools.call({ domain, tool, args })only when no matching./sdkdescriptor is available or the tool is discovered dynamically at runtime. - When you discover tools through
session.tools.list({ domain }), treat the returnedshortNameas the canonical tool name to pass back into a later call-by-name invocation. Do not invent camelCase aliases or normalize tool names yourself. - Prefer stable SDK domain identifiers such as built-in domain IDs (
network,react,memory) and plugin IDs (@rozenite/storage-plugin,@rozenite/tanstack-query-plugin) over the derived, CLI-facing domain token likestorage. - For paged tools, make one call at a time and pass the returned
page.nextCursorexplicitly in the next call. The plugin owns its page envelope and cursor. - If a plugin only mounts after navigation, navigate first, then refresh the live view with
session.domains.list()orsession.tools.list(...)before calling the plugin tool. - For advanced session control with
client.openSession()orclient.attachSession(sessionId), see the reference patterns. - If a script encounters an unexpected runtime error, let the script fail clearly. Do not hide the failure by printing placeholder JSON.
Handoff
- Use
rozenite-agentinstead when the task is shell-driven, needs a reusable CLI session, operates directly throughrozenite agent ..., or requires target enumeration before choosing adeviceId.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/callstackincubator/rozenite/rozenite-agent-sdk">View rozenite-agent-sdk on skillZs</a>