coldbox-module-development

Create reusable ColdBox modules with routes, handlers, services, and configuration.

1|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/ColdBox/skills --skill coldbox-module-development
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: coldbox-module-development
Source: https://github.com/ColdBox/skills/tree/main/coldbox/module-development
Command: npx skills add https://github.com/ColdBox/skills --skill coldbox-module-development

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ColdBox module development can be error-prone without a clear blueprint. This skill provides a complete structure for building reusable modules with ModuleConfig.cfc, box.json metadata, routing, interceptors, and WireBox bindings to ensure isolation and portability across projects.

Core Features & Use Cases

  • Modular architecture: self-contained modules with their own routes, handlers, services, and configuration.
  • ForgeBox packaging and deployment: ready-to-publish ForgeBox-ready modules.
  • Module inception and dependency management: safe composition of modules across projects.

Quick Start

Create a new module folder with ModuleConfig.cfc, a Router, and a box.json, then package and publish to ForgeBox.

Frequently Asked Questions about coldbox-module-development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a reusable ColdBox module with isolated routes and handlers?▼

To create a reusable ColdBox module, build a self-contained folder with a ModuleConfig.cfc, dedicated Router, handlers, and services. This structure ensures module isolation and easy deployment across ColdBox projects.

What do I need to package a ColdBox module for ForgeBox deployment?▼

Packaging a ColdBox module for ForgeBox requires a box.json metadata file alongside your ModuleConfig.cfc. This combination provides the necessary deployment blueprint for publishing ready-to-install modules.

How does WireBox binding work within ColdBox module development?▼

WireBox bindings in ColdBox module development allow modules to manage dependency injection independently. Configuring WireBox within ModuleConfig.cfc ensures self-contained services and safe composition across different projects.

Can I use ColdBox modules with BoxLang and CFML compatibility?▼

Yes, ColdBox modules conform to BoxLang CFML compatibility standards. Building modules with ModuleConfig.cfc and interceptors ensures they function correctly within BoxLang environments.

When do I need interceptors in a ColdBox module?▼

You need interceptors in a ColdBox module when requiring event-driven architecture within self-contained routes. Configuring interceptors inside ModuleConfig.cfc allows modules to hook into application events cleanly.

Why use modular architecture for multi-module ColdBox applications?▼

Modular architecture provides self-contained isolation for multi-module ColdBox applications, preventing handler conflicts. Using ModuleConfig.cfc and independent routers ensures safe composition and portability across projects.