erupt-skill
English | 简体中文
A Claude Code Skill that generates a data admin backend from a single sentence.
Powered by the erupt low-code framework: say "build me a library admin backend" and get a complete, runnable admin system — login page, CRUD, search, import/export, and permission management out of the box.
No dev environment required: with no system JDK, the skill downloads OpenJDK 25 on demand (Adoptium official source, with a Tsinghua mirror fallback that's fast in China; cached in ~/.erupt-skill), Maven is prepared automatically, project dependencies go through the Aliyun mirror, and an embedded H2 file database means no MySQL install. The repo itself stays ~1 MB, so cloning is instant. Non-developers can build a data admin backend for any domain with one sentence.
Install
This skill follows the open Agent Skills standard (SKILL.md), supported by most mainstream AI coding tools. Clone the repo into the skills directory of your tool:
| Tool | Skills directory | Notes |
|---|
| Claude Code | ~/.claude/skills/ (personal) or .claude/skills/ (project) | Native support, auto-activates by description |
| Codex CLI | ~/.codex/skills/ (personal) or .codex/skills/ (project) | Invoke with $erupt-admin ... or auto-activation |
| Cursor | .cursor/skills/ or .agents/skills/ (project) | See Cursor Agent Skills docs |
| Trae | .agents/skills/ (project) | Supports the Agent Skills open standard |
| CodeBuddy | .agents/skills/ (project) | Supports the Agent Skills open standard |
Example (Claude Code):
git clone https://github.com/plinian/erupt-skill.git ~/.claude/skills/erupt-admin
For any tool without native skill support, just clone this repo anywhere and tell the agent: "Read SKILL.md in this repo and follow its workflow to build me a XXX admin backend."
Usage
Just say in Claude Code:
Build a library admin backend
Create a customer order management system with status filtering
Add a borrow-record module to the backend you just built
Then open http://localhost:8080 and log in with erupt / erupt.
Directory Structure
SKILL.md # main skill workflow
reference/annotations.md # entity generation spec (decision tables + common pitfalls)
reference/erupt-*.md # official erupt reference docs (annotations, i18n, query, Cube, API, TPL)
template/ # runnable erupt project template (latest erupt release + Spring Boot 3.5 + H2)
└─ resources/public/ # app.js (eruptSiteConfig: title/logo/theme/hooks) · app.css (styles)
scripts/setup-env.sh # prepare JDK + Maven (system JDK → cached → download JDK: Adoptium official, Tsinghua mirror fallback)
scripts/compile.sh # compile-only check (catch syntax errors after code changes)
scripts/run.sh # one-command build and start
scripts/build-m2-seed.sh # optional: build a local dependency seed into vendor/m2 for fully-offline first builds
Requirements
- macOS / Linux / Windows (on Windows run inside Git Bash, which Claude Code ships with)
- Network access (first run downloads Maven and project dependencies; with no system JDK it also downloads OpenJDK 25 once, then caches it)
