boxlang-agent-skills

BoxLang Skills

AI agent skills for BoxLang — a Modern Dynamic JVM Language built on JRE 21+.

This repository provides reusable AI skills for BoxLang development, compatible with any agent that supports the skills.sh open standard — including Claude Code, Cursor, Copilot, and more.

Skills inject BoxLang domain knowledge directly into your AI agent so it can write accurate, idiomatic BoxLang code for you.

You can find all our skills published to our online directory at https://skills.boxlang.io/.

---

What Are Skills?

Skills are Markdown files (SKILL.md) that give your AI agent expert-level context on a specific topic. They are discovered and loaded automatically by the agent when relevant — a query about async programming loads the async skill, a question about deployment loads the deployment skill, and so on.

Each skill in this repo contains:

• Language syntax and idioms with working code examples
• API references and BIF signatures
• Configuration patterns
• Best practices and gotchas

Skill identifiers now use the boxlang-dev-* naming convention for easier discovery in installed skill lists.

---

Quick Install

Requires Node.js — no installation needed, just npx:

# Install ALL BoxLang skills (all categories)
npx skills add ortus-boxlang/skills

That's it. Your AI agent now has BoxLang and CommandBox expertise.

Claude Plugin Install

Install this repository as a Claude plugin:

claude plugin install https://github.com/ortus-boxlang/skills

If you use plugin marketplace commands:

/plugin marketplace add ortus-boxlang/skills
/plugin install boxlang-agent-skills@ortus-boxlang

ColdBox CLI

# Install the ColdBox CLI if you haven't already
box install coldbox-cli

# Install AI integration into your app
# This reads your app, box.json and installs skills based on your stack and preferences
coldbox ai install

# Skills Management

# List installed skills
coldbox ai skills list
# Add a skill
coldbox ai skills add Ortus-Solutions/skills/vuejs-expert
# Remove a skill
coldbox ai skills remove vuejs-expert

All skills are installed at .agents/skills/ in your project.

---

Categories

boxlang-developer — Building Applications with BoxLang

For developers writing BoxLang applications: web apps, APIs, database access, async pipelines, caching, Java interop, module usage, and deployment.

npx skills add ortus-boxlang/skills/boxlang-developer

Skill	What It Covers
boxlang-dev-application-descriptor	Application.bx discovery, multi-app isolation, lifecycle callbacks, app-level this.* settings, and app-scoped this.schedulers/this.watchers wiring
boxlang-dev-boxlang-async-programming	BoxFuture, futureNew, asyncRun, asyncAll, asyncAny, asyncAllApply, executors (io-tasks/cpu-tasks/scheduled-tasks), schedulers, thread component, bx:lock
boxlang-dev-boxlang-file-watchers	Filesystem watcher lifecycle (watcherNew/watcherStart/watcherStop), listener strategies (closure/struct/class), event payload handling, debounce/throttle tuning, and watcher stats
boxlang-dev-boxlang-best-practices	Naming conventions, scoping, function structure, error handling, performance, and maintainability guidelines
boxlang-dev-boxlang-caching	Cache providers, named regions, cachePut/cacheGet, output caching, Redis, Couchbase, TTL policies, distributed locking
boxlang-dev-boxlang-cfml-migration	Key syntax and behavioral differences, bx-compat-cfml module, converting file types, fixing common migration issues
boxlang-dev-boxlang-classes-and-oop	Classes, inheritance, interfaces, abstract classes, properties, constructors, static members, annotations, final constructs, method chaining
boxlang-dev-boxlang-code-documenter	Javadoc-style function/class comments, argument and return-type docs, DocBox-compatible annotations
boxlang-dev-boxlang-code-reviewer	Code quality, correctness, security vulnerabilities, performance, style — structured review feedback
boxlang-dev-boxlang-configuration	boxlang.json runtime settings, datasources, caches, executors, modules, logging, security, schedulers