Ebean Agent Skills

Ebean Agent Skills are structured knowledge packages that compatible coding agents can load on demand when working with Ebean ORM.

They follow the Agent Skills specification and work with skill-aware tools including pi and Claude Code.

Available skill

The ebean-orm skill gives the agent Ebean-specific guidance for entity beans, query beans, transactions, testing, project setup, and migration generation.

Installation

Option A - Clone and symlink (recommended)

 git clone https://github.com/ebean-orm/skills.git ~/.agents/ebean-skills
 mkdir -p ~/.agents/skills
 ln -sf ~/.agents/ebean-skills/ebean-orm ~/.agents/skills/ebean-orm

To update:

 cd ~/.agents/ebean-skills && git pull

Option B - Clone and copy into the skills directory

 git clone https://github.com/ebean-orm/skills.git /tmp/ebean-skills
 mkdir -p ~/.agents/skills
 cp -r /tmp/ebean-skills/ebean-orm ~/.agents/skills/ebean-orm
 rm -rf /tmp/ebean-skills

Option C - Project-level installation

To make the skill available to everyone working on a specific project, copy it into a checked-in .agents/skills directory.

 # from your project root
 git clone https://github.com/ebean-orm/skills.git /tmp/ebean-skills
 mkdir -p .agents/skills
 cp -r /tmp/ebean-skills/ebean-orm .agents/skills/ebean-orm
 rm -rf /tmp/ebean-skills
 git add .agents/skills/ebean-orm

Verification

After installation, verify that the skill is visible to your coding tool. In pi:

 /skills

You should see ebean-orm listed.

How it works

The skill uses progressive disclosure.

1. The tool initially sees only the skill name and description.
2. When a task matches Ebean work, it loads SKILL.md.
3. SKILL.md provides key principles, a quick reference, and links to the detailed guides.
4. The tool then loads only the guide needed for the task at hand.

This keeps the default instruction set small while still giving the tool detailed Ebean guidance when needed.

Skill structure

 ebean-orm/
 ├── SKILL.md
 └── references/
     ├── setup.md
     ├── modeling.md
     ├── querying.md
     ├── write-transactions.md
     ├── testing.md
     └── db-migrations.md

• setup.md - project setup, dependencies, and configuration
• modeling.md - entity modeling and relationships
• querying.md - query beans, fetch tuning, and DTO queries
• write-transactions.md - save, update, delete, and transactions
• testing.md - testing patterns and tools
• db-migrations.md - migration generation and execution

Repository

Source repository: github.com/ebean-orm/skills