open-agent-sdk — Claude Code skill: what it does, how to install
Guides you in deploying in-process TypeScript AI agents without local CLI dependencies. Useful for cloud containers and serverless tasks.
npx skills add reason-machines/trending-skills --skill open-agent-sdk -a claude-codeWhat open-agent-sdk does
The @shipany/open-agent-sdk package offers an open alternative to @anthropic-ai/claude-agent-sdk. This skill explains how to embed the autonomous loop directly into a Node.js process instead of spawning CLI subshells.
It covers core functions such as streaming query() and stateful createAgent(). Setup options include restricting tool access via allowedTools, setting turn limits, and wiring external MCP servers over stdio or HTTP.
Running this requires Node.js 18+ and an ANTHROPIC_API_KEY. Without them, execution fails immediately.
What it helps with
- run agent loops in-process without CLI subshells
- configure MCP servers in TypeScript applications
- restrict allowed tools for read-only agent workflows
- route agent requests to custom endpoints using baseURL
Example prompts for the agent
- Show how to set up createAgent with read-only tools using open-agent-sdk
- How do I add an MCP filesystem server with open-agent-sdk in TypeScript?
- Migrate my project from claude-agent-sdk to open-agent-sdk
How to install open-agent-sdk
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill open-agent-sdk -a claude-code2Manually: put the files in place
~/.claude/skills/open-agent-sdk/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/open-agent-sdk/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill open-agent-sdk -a codex2Manually: put the files in place
.agents/skills/open-agent-sdk/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill open-agent-sdk -a cursor2Manually: put the files in place
.cursor/skills/open-agent-sdk/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills open-agent-sdk2Manually: put the files in place
.github/skills/open-agent-sdk/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill open-agent-sdk -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/open-agent-sdkManually: put the files in place
.devin/skills/open-agent-sdk/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill open-agent-sdk -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about open-agent-sdk
How to install open-agent-sdk in Claude Code?
Run npx skills add reason-machines/trending-skills --skill open-agent-sdk -a claude-code.
What does open-agent-sdk do?
It provides reference patterns and API instructions for building in-process TypeScript agents without external CLI dependencies.
What are the prerequisites for open-agent-sdk?
You need Node.js version 18 or newer and an API key exported as ANTHROPIC_API_KEY.