Avaje Skills for AI Coding Agents

Structured knowledge packages that AI coding agents load on-demand when working with Avaje libraries.

These skills follow the Agent Skills standard and work with any compatible harness, including pi and Claude Code.

Available Skills

Skill	Description
avaje-nima	Avaje Nima web framework — controllers, DI, config, JSON, testing, Docker, native image
avaje-inject	Avaje Inject standalone DI + avaje-config — for projects without avaje-nima
avaje-config	Avaje Config external configuration — YAML/properties, profiles, env vars, AWS AppConfig
avaje-jsonb	Avaje Jsonb compile-time JSON — adapters, polymorphism, streaming
avaje-simple-logger	Avaje Simple Logger — lightweight SLF4J, replacing Logback, AWS AppConfig dynamic log levels

Which skill do I need?

• Building an avaje-nima web service? → Use avaje-nima (includes DI, config, JSON)
• Using avaje-inject without a web framework? → Use avaje-inject
• Using avaje-config standalone? (e.g., with Spring or plain Java) → Use avaje-config
• Using avaje-jsonb standalone? → Use avaje-jsonb
• Adding or configuring logging? → Use avaje-simple-logger

Installation

Option A — Clone and symlink (recommended)

git clone git@github.com:avaje/skills.git ~/.agents/avaje-skills
mkdir -p ~/.agents/skills

# Symlink the skills you need
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

To update:

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

Option B — Copy into skills directory

git clone git@github.com:avaje/skills.git /tmp/avaje-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

git clone git@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 in pi:

/skills

You should see avaje-nima, avaje-inject, avaje-config, and/or avaje-jsonb listed.

Regenerating References

The reference files are generated by concatenating source guides from the avaje repos (avaje-nima, avaje-inject, avaje-config, avaje-jsonb).

# Expects sibling repo checkouts at ../avaje-nima, ../avaje-inject, etc.
./generate-references.sh

# Or specify the parent directory
AVAJE_DIR=/path/to/avaje ./generate-references.sh

License

Apache 2.0 — see LICENSE.