PlugWiki

Elysia skill for Claude Code: build, debug and migrate Elysia v2 backends

Makes Claude follow Elysia v2 rules when it builds, debugs or migrates a TypeScript backend, and sends it to detailed reference files.

Installs
14.4K
on skills.sh
Stars
70
on GitHub
Files
24
besides SKILL.md
Updated
Oct 2026
last repo commit

It starts when your project uses Elysia or you ask for Elysia work. Claude first reads package.json, the lockfile, the runtime and the app layout, and keeps your existing versions unless you ask for a migration. It then loads only the reference files the task needs, and ends by checking types and exercising the changed route, including the case where input is rejected.

The rules target Elysia 2.0.0-rc.0 or newer, which is a prerelease. SKILL.md also tells Claude to check the real Elysia documentation for new features instead of relying on the skill alone. The folder bundles reference files and a metadata.json and no scripts.

Good for

  • Developers building an API with Elysia v2 on Bun, Node, Deno or Workers
  • Teams moving an Elysia v1 app to v2 who want the differences spelled out
  • Developers who want typed client calls (Eden) and OpenAPI docs from the same routes

Install elysiajs

Claude Code

  1. 1

    Copy this prompt.

    Install the elysiajs skill in Claude Code. Run this command:

npx skills add https://github.com/elysiajs/skills --skill elysiajs

Then check that it loaded and tell me how to use it.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

The skill folder is elysia in the repo, and its references subfolder must come along. The skills CLI copies it for you; for a manual copy take the whole folder.

From its listing on skills.sh. Source.

What's in the skill

When it loads

Build, debug, or migrate Elysia v2 TypeScript backends with validation, plugins, typed clients, and deployment. Use for Elysia projects or explicit Elysia requests.

Sections in SKILL.md

  1. Start here
  2. Essential rules
  3. Minimal app and test
  4. Choose a reference
  5. Defaults for a new project

Key facts

Author
ElysiaJS (named as the organization in metadata.json)
Repo
elysiajs/skills
License
Not stated: the repo has no LICENSE file and no README
Installs on skills.sh
14,433 (Nov 2, 2026)
GitHub stars
70 (Nov 2, 2026)
Last commit to the repo
Oct 19, 2026
What installs
25 files in the elysia folder: SKILL.md, metadata.json and 23 reference files, no scripts
Targets
Elysia 2.0.0-rc.0 or newer per SKILL.md; versions.md pins a baseline of 2.0.0-beta.32
skills.sh audits
Gen Agent Trust Hub: pass, Socket: pass, Snyk: pass

What it includes

  • Reads package.json, lockfile and runtime first, and keeps your existing versions

    Claude inspects the project before it writes anything. For a v1 project it uses the migration reference to spot differences, and does not treat it as permission to upgrade.

    Files · Start here

  • Eleven short rules on handlers, hooks, plugins, errors, schemas and context

    Examples: options come before the handler, keep the returned type by chaining, order hooks before routes, return expected failures with status(), and use guard schemas knowing they override by default.

    Essential rules

  • A small route plus a test that checks a valid and a rejected request

    The example calls app.handle() under bun test, so it opens no port. It expects 200 for /users/42 and 422 for /users/nope.

    Runs code · Minimal app and test

  • Routes Claude to one of 23 reference files by task

    Topics include core API, lifecycle, composition, validation, errors, cookies, WebSockets, testing, Eden, OpenAPI, runtimes, deployment, observability, official plugins, Drizzle, Prisma, Better Auth, AI SDK, React Email and migration.

    Choose a reference

  • Lists the package versions the skill was checked against

    versions.md pins elysia 2.0.0-beta.32 and lists baselines for the @elysia plugins. It says these come from local repositories and do not prove a release is available.

    Versions reference

  • Bun and t schemas, with Eden and OpenAPI added when useful

    Small apps stay in one file and larger ones are split by feature.

    Defaults for a new project

  • Tells Claude to read the llms.txt files for Elysia 1 or 2

    SKILL.md says the skill is a guide to the documentation, not a replacement, and links the llms.txt for each version.

    Network · Live docs pointers

From the official docs

Permissions

Low risk

Claude edits your backend code and may run installs, builds and tests while following the skill. Review each command and each change before you accept it.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It targets a prerelease version of Elysia

    SKILL.md says Elysia 2.0.0-rc.0 or newer, and versions.md pins 2.0.0-beta.32 and says it does not prove releases or integrations. Check peer requirements before you install. github.com

  • Reference files include build and container commands

    deploy.md shows bun build --compile, bun install --frozen-lockfile and docker build. Read each one Claude proposes before you approve it. github.com

  • Reference files include package install commands

    versions.md shows bun add elysia@2.0.0-beta.32, runtimes.md shows deno add npm:elysia@2.0.0-beta.32, and drizzle.md shows npm i drizzle-orm@rc typebox. Check availability and peer requirements before you install. github.com

  • No license file in the repo

    The repo carries no LICENSE, so reuse terms are unstated. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details
Turning on read-onlyNo read-only mode. Ask Claude to explain or review instead of change.
Talks toelysiajs.com (llms.txt for Elysia 1). next.elysiajs.com (llms.txt for Elysia 2)
Scopes

  • Edits your Elysia source files and tests when you ask for changes

  • Asks Claude to run your project's test and type check commands

  • Reference files show package and build commands (bun add, bun build, npm i, docker build, deno add)

Questions

How do I install the Elysia skill?

Use the install box above. The repo has no top-level README, so the install command comes from the skills.sh listing. It copies the elysia folder, which includes the reference files.

Does it work with Elysia v1?

It is written for v2. For a v1 project, SKILL.md says to use the migration reference to recognize differences, not as permission to upgrade, and points to the Elysia 1 llms.txt for v1 docs.

Is Elysia v2 stable?

SKILL.md says it describes 2.0.0-rc.0 or newer, and versions.md pins a 2.0.0-beta.32 baseline reviewed on 2026-10-17. Both are prerelease versions, and the two files name different versions. Check which version your project resolves before you follow it.

Will it run commands or install packages?

The skill bundles no scripts. Its instructions ask Claude to run your project's tests and type check, and its reference files show commands such as bun add, bun build, docker build and deno run. Approve those like any other command Claude proposes.

Does it replace the Elysia docs?

No. SKILL.md says to always consult the actual documentation for the latest features, and calls the skill a guide to the documentation.

Is it official?

It lives in the elysiajs GitHub organization, and metadata.json names ElysiaJS as the organization. The repo carries no license file, so check with the maintainers if you need to reuse the text.

Information

updated Nov 2, 2026

Repository
elysiajs/skills
Folder
elysia

elysiajs/skillsskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 7
  1. skills.sh listing · skills.sh
  2. elysiajs SKILL.md · github.com
  3. elysia metadata.json · github.com
  4. versions.md · github.com
  5. deploy.md · github.com
  6. elysiajs/skills runtimes.md · github.com
  7. elysiajs/skills drizzle.md · github.com

Updated Nov 2, 2026.