create-headless-agent — Claude Code skill: setup and features
create-headless-agent scaffolds headless TypeScript agents using Bun and @openrouter/agent. Builds CLI utilities, API servers, queue workers, and data pipelines without a terminal UI.
no license 320 installs ★ 327 updated 2026-11-06
npx skills add OpenRouterTeam/skills --skill create-headless-agent -a claude-codeWhat create-headless-agent does
The skill sets up a headless TypeScript project without readline interfaces or ANSI styling. It relies on @openrouter/agent to manage the core loop: model queries, tool calls, and exit conditions. You get a clean programmatic wrapper exposing the agent as a CLI command, a library export, a Bun.serve() HTTP server, or an MCP server.
During scaffolding, it asks for the project name and presents an interactive checklist of features. You can toggle OpenRouter server-side tools like web search or datetime, attach local file utilities, and configure architecture modules such as JSONL session persistence or Zod schema validation.
The local shell tool stays locked until you pass --allow-shell, and once enabled, it runs outside working directory boundaries. Running the generated agent requires Bun 1.1 or higher alongside a valid OPENROUTER_API_KEY.
What it helps with
- scaffold a headless CLI agent in TypeScript running on Bun
- expose an OpenRouter agent pipeline as an HTTP server or MCP tool
- automate batch file tasks with programmatic model calls and JSON output
- build queue workers with retry logic and persistent JSONL sessions
Example prompts for the agent
- Scaffold a headless agent in TypeScript for automated data processing with Bun
- Create a CLI tool using @openrouter/agent with web search and file edit tools
- Set up an MCP server entry point for a headless OpenRouter agent
How to install create-headless-agent
1Skills CLI (Vercel)
npx skills add OpenRouterTeam/skills --skill create-headless-agent -a claude-code2Manually: put the files in place
~/.claude/skills/create-headless-agent/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/create-headless-agent/
1Skills CLI (Vercel)
npx skills add OpenRouterTeam/skills --skill create-headless-agent -a codex2Manually: put the files in place
.agents/skills/create-headless-agent/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add OpenRouterTeam/skills --skill create-headless-agent -a cursor2Manually: put the files in place
.cursor/skills/create-headless-agent/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install OpenRouterTeam/skills skills/create-headless-agent2Manually: put the files in place
.github/skills/create-headless-agent/SKILL.md1Skills CLI (Vercel)
npx skills add OpenRouterTeam/skills --skill create-headless-agent -a gemini-cli2Platform CLI
gemini skills install https://github.com/OpenRouterTeam/skills --path skills/create-headless-agentManually: put the files in place
.devin/skills/create-headless-agent/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add OpenRouterTeam/skills --skill create-headless-agent -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 create-headless-agent
How do I install create-headless-agent in Claude Code?
Run npx skills add OpenRouterTeam/skills --skill create-headless-agent -a claude-code in your terminal.
What does create-headless-agent do?
It scaffolds a complete headless agent project in TypeScript on Bun, wired to OpenRouter models without terminal UI overhead.
What prerequisites are required to run the generated code?
You need Bun version 1.1 or newer and an OPENROUTER_API_KEY set in your environment.