Agent Skills
Avaje Agent Skills are structured knowledge packages that AI coding agents can load on-demand when working with Avaje libraries.
These skills follow the Agent Skills specification and work with compatible coding agent harnesses including pi and Claude Code.
Available skills
| Skill | Description | Library docs |
|---|---|---|
avaje-nima |
Avaje Nima web framework guidance for controllers, DI, config, JSON, testing, Docker, and native image. | Nima |
avaje-inject |
Compile-time dependency injection guidance for standalone DI usage with avaje-config. | Inject |
avaje-config |
External configuration guidance for YAML/properties, profiles, environment variables, and AWS AppConfig. | Config |
avaje-jsonb |
Compile-time JSON serialisation guidance for adapters, custom serializers, polymorphism, and streaming. | Jsonb |
avaje-simple-logger |
Lightweight SLF4J logging guidance for replacing Logback and using dynamic log levels with AppConfig. | Simple Logger |
Which skill do I need?
- Building an avaje-nima web service? Use
avaje-nima. It covers the integrated stack including DI, config, and JSON. - Using avaje-inject without a web framework? Use
avaje-inject. - Using avaje-config standalone? Use
avaje-config. - Using avaje-jsonb standalone? Use
avaje-jsonb. - Adding or configuring logging? Use
avaje-simple-logger.
Installation
Install the skills that are relevant to the libraries your agent will work with.
Option A - Clone and symlink (recommended)
git clone https://github.com/avaje/skills.git ~/.agents/avaje-skills
mkdir -p ~/.agents/skills
ln -sf ~/.agents/avaje-skills/avaje-nima ~/.agents/skills/avaje-nima
ln -sf ~/.agents/avaje-skills/avaje-inject ~/.agents/skills/avaje-inject
ln -sf ~/.agents/avaje-skills/avaje-config ~/.agents/skills/avaje-config
ln -sf ~/.agents/avaje-skills/avaje-jsonb ~/.agents/skills/avaje-jsonb
ln -sf ~/.agents/avaje-skills/avaje-simple-logger ~/.agents/skills/avaje-simple-logger
Updating is then just:
cd ~/.agents/avaje-skills && git pull
Option B - Copy into the skills directory
git clone https://github.com/avaje/skills.git /tmp/avaje-skills
mkdir -p ~/.agents/skills
cp -r /tmp/avaje-skills/avaje-nima ~/.agents/skills/avaje-nima
cp -r /tmp/avaje-skills/avaje-inject ~/.agents/skills/avaje-inject
cp -r /tmp/avaje-skills/avaje-config ~/.agents/skills/avaje-config
cp -r /tmp/avaje-skills/avaje-jsonb ~/.agents/skills/avaje-jsonb
cp -r /tmp/avaje-skills/avaje-simple-logger ~/.agents/skills/avaje-simple-logger
rm -rf /tmp/avaje-skills
Option C - Project-level installation
If you want skills checked into a specific project, copy them into a local .agents/skills directory.
git clone https://github.com/avaje/skills.git /tmp/avaje-skills
mkdir -p .agents/skills
cp -r /tmp/avaje-skills/avaje-nima .agents/skills/avaje-nima
rm -rf /tmp/avaje-skills
git add .agents/skills/avaje-nima
Verification
After installation, verify that your coding agent can see the skills.
/skills
In pi you should then see the installed Avaje skills listed, such as avaje-nima,
avaje-inject, avaje-config, avaje-jsonb, and
avaje-simple-logger.
Repository
The source for these skills is maintained in github.com/avaje/skills.
The skill content is designed to help agents apply Avaje conventions and library-specific guidance more accurately when generating or modifying code.