elysiajs — Claude Code skill: what it does, how to install
This skill helps build, debug, and migrate Elysia v2 TypeScript backends. Use it for routes, schemas, plugins, typed clients, and deployment work.
npx skills add elysiajs/skills --skill elysiajs -a claude-code
npx skills add elysiajs/skills --skill elysia -a claude-codeWhat elysiajs does
The skill inspects package.json, the lockfile, runtime, and project structure before helping with an Elysia v2 backend. It covers schema validation, hooks, plugins, typed clients, OpenAPI, WebSockets, tests, migration work, and deployment.
Its references cover the core API, lifecycle, composition, errors, project structure, Eden, databases, and runtimes. For a new project, it advises Bun with t schemas. Testing includes the affected route and its rejection path, along with the project’s type check.
Node work needs @elysia/node and Node 22.18 or newer, while WebSockets need elysia/websocket. Check the runtime and package versions before a migration because the skill targets Elysia v2 and does not treat an upgrade as automatic.
What it helps with
- build a TypeScript backend with Elysia v2
- test a route and its rejection path
- define request data with
tschemas - add a plugin or typed client
- migrate an Elysia v1 project to v2
Example prompts for the agent
- Inspect
src/app.tsandpackage.json, find the Elysia v2 route issues, and add tests for a valid request and a rejected request. - Build a new Elysia backend on Bun with
tschemas, an Eden typed client, and tests intest/app.test.ts. - Migrate this Elysia v1 route to v2, keep the current package versions, and run
bun testplus the project type check.
How to install elysiajs
1Skills CLI (Vercel)
npx skills add elysiajs/skills --skill elysiajs -a claude-codenpx skills add elysiajs/skills --skill elysia -a claude-code2Manually: put the files in place
~/.claude/skills/elysia/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/elysia/
1Skills CLI (Vercel)
npx skills add elysiajs/skills --skill elysia -a codex2Manually: put the files in place
.agents/skills/elysia/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add elysiajs/skills --skill elysia -a cursor2Manually: put the files in place
.cursor/skills/elysia/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install elysiajs/skills elysia2Manually: put the files in place
.github/skills/elysia/SKILL.md1Skills CLI (Vercel)
npx skills add elysiajs/skills --skill elysia -a gemini-cli2Platform CLI
gemini skills install https://github.com/elysiajs/skills --path elysiaManually: put the files in place
.devin/skills/elysia/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add elysiajs/skills --skill elysia -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 elysiajs
How do I install elysiajs in Claude Code?
Run npx skills add elysiajs/skills --skill elysiajs -a claude-code, then check ~/.claude/skills/elysia/SKILL.md.
What does the elysiajs skill do?
It helps build, debug, and migrate Elysia v2 TypeScript backends. The skill covers schemas, hooks, plugins, typed clients, testing, and deployment.
What is required to use Elysia on Node?
Node work requires @elysia/node and Node 22.18 or newer. WebSocket routes require elysia/websocket.
