QloApps Agent Skills

Agent skills for QloApps — a free and open-source hotel commerce solution.

These skills provide domain-specific, reusable context for AI agents (Claude Code, Cursor, Windsurf, etc.) working inside a QloApps codebase.

Available Skills

module-development

Create, build, or modify QloApps modules. Covers hooks-first architecture, ObjectModel classes, admin and front controllers, Smarty templates, database operations, security validation, and deployment.

Activates when: creating modules, working with hooks, ObjectModel classes, admin or front controllers, Smarty templates, database operations, or module deployment — or when the user mentions module, hook, ObjectModel, controller, template, override, or needs to build or modify a QloApps module.

---

stats-module-development

Create, modify, or debug QloApps statistics modules displayed under AdminStats. Covers ModuleGrid (tables), ModuleGraph (charts), and plain Module (dashboards).

Activates when: creating statistics modules, building reports, working with ModuleGrid or ModuleGraph, implementing hotel analytics, occupancy calculations, or revenue reporting — or when the user mentions stats, statistics, report, chart, graph, grid, analytics, occupancy, ADR, RevPAR, or needs to add a new stats module to the admin panel.

---

payment-module-development

Create, modify, or debug payment modules in QloApps. Covers PaymentModule class, payment hooks, checkout integration, validateOrder flow, API credentials, webhook handling, transaction logging, and refunds.

Activates when: creating payment methods, integrating payment gateways, handling webhooks, or implementing transaction flows — or when the user mentions payment, payment gateway, payment method, checkout, validateOrder, webhook, refund, or needs to add a new payment option to the booking flow.

---

Install

Install all skills from this repo into your AI agent:

npx skills add Qloapps/agent-skills

Install a specific skill only:

npx skills add Qloapps/agent-skills --skill "module-development"
npx skills add Qloapps/agent-skills --skill "stats-module-development"
npx skills add Qloapps/agent-skills --skill "payment-module-development"

Install for a specific agent:

npx skills add Qloapps/agent-skills -a claude-code
npx skills add Qloapps/agent-skills -a cursor

Repository Structure

agent-skills/
├── skills/
│   ├── module-development/
│   │   ├── SKILL.md
│   │   └── reference/
│   │       ├── architecture.md
│   │       ├── coding-conventions.md
│   │       ├── controllers.md
│   │       ├── database-operations.md
│   │       ├── deployment.md
│   │       ├── hooks-system.md
│   │       ├── models-repositories.md
│   │       ├── security-validation.md
│   │       └── templates-views.md
│   ├── stats-module-development/
│   │   ├── SKILL.md
│   │   └── reference/
│   │       ├── module-grid-pattern.md
│   │       ├── module-graph-pattern.md
│   │       ├── query-patterns.md
│   │       └── ui-performance.md
│   └── payment-module-development/
│       ├── SKILL.md
│       └── reference/
│           ├── controllers-transactions.md
│           ├── integration-api.md
│           ├── module-structure.md
│           └── payment-patterns.md
└── README.md

Each skill folder contains a SKILL.md file with agent-readable instructions and a YAML frontmatter block that defines when the skill activates, along with a reference/ directory containing detailed guides.