Skill Claude CodeCodex
Use when setting up a basic Zolinga installation, checking prerequisites, fixing writable-path problems, configuring the local URL, and starting the framework for the first time.
🤖 A PHP framework built by people, for AI. Lightweight, extensible, and handcrafted from the ground up, with native MCP support and every detail micro-optimized to use fewer AI tokens. ✨
Skill Claude CodeCodex
Use when setting up a basic Zolinga installation, checking prerequisites, fixing writable-path problems, configuring the local URL, and starting the framework for the first time.
Skill Claude CodeCodex
Use when: working with this module. Replace this description with specific trigger phrases describing what the skill helps accomplish and when to invoke it.
Skill Claude CodeCodex
Use when creating actionable, trackable plan documents in the /TODO folder — reviews, audits, new features, refactors, migrations, any multi-step work. Covers the TOC-with-progress-counters format, atomic checkbox steps, mandatory validation step per block, heading hierarchy, and concise author-to-author tone.
Skill Claude CodeCodex
Use when creating or editing module zolinga.json manifests, including listen/emit/autoload/config/webComponents/dependencies conventions and validation-oriented authoring.
Skill Claude CodeCodex
Use when creating or updating CHANGELOG.md files in Zolinga modules. Covers Keep a Changelog format, SemVer versioning, and the rule that every zolinga.json version bump must be accompanied by a CHANGELOG.md entry.
Skill Claude CodeCodex
Use BEFORE building any new feature, page, or capability. The Zolinga core ships alone — official modules (CMS, DB, Intl, Commons, Cron, RMS, AI) provide most common features. Install them instead of hand-rolling a custom module. Always read README.md "Pre-Loaded Modules" first.
Skill Claude CodeCodex
Use when creating or modifying code in Zolinga modules, especially for following established coding standards and best practices.
Skill Claude CodeCodex
Use when implementing inter-process locking or concurrency control in Zolinga modules. Covers the registry-based MySQL lock API.
Skill Claude CodeCodex
Use when implementing CMS content tag handlers (cms:content:tagName), including listener contracts, DOM manipulation rules, and required wiki docs.
Skill Claude CodeCodex
Use when exposing an existing origin: ["remote"] listener as an MCP tool without rewriting the handler. Covers the one-line manifest pattern that re-uses the same class+method, plus the minimal schema work needed to satisfy McpToolsListHandler::collectTools(). Complements system-create-mcp-tool (which covers the…
Skill Claude CodeCodex
Use when creating a new event handler/listener in a Zolinga module, including event naming, class placement, origin filtering, rights checks, and event object selection.
Skill Claude CodeCodex
Use when creating or updating MCP prompts — reusable prompt templates exposed to MCP clients via prompts/list and prompts/get. Covers .meta.json definitions, tenant filtering, content.uri file references, {{arg}} substitution, and the mcp-system scheme.
Skill Claude CodeCodex
Use when creating or updating MCP resources — static files exposed to MCP clients via resources/list and resources/read. Covers .meta.json descriptors, tenant filtering, URI rewriting, dynamic resources via mcp:resources/list event hook, and the mcp-system scheme.
Skill Claude CodeCodex
Use when exposing a Zolinga event handler as an MCP (Model Context Protocol) tool — i.e. a method clients can invoke via JSON-RPC tools/call. Covers handler class, manifest binding, JSON Schemas, the Tools\CallEvent contract, and the schema.response requirement enforced by McpToolsListHandler::collectTools().
Skill Claude CodeCodex
Use when creating or wiring a Zolinga service exposed on global $api via system:service events, including manifest sugar, naming, initialization, and special service/listener combinations.
Skill Claude CodeCodex
Use when creating, updating, or consolidating Agent Skills in this repository, including canonical placement, naming, and AGENTS.md alignment.
Skill Claude CodeCodex
Use when creating module-specific API endpoints in install/dist and wiring them to load the Zolinga system correctly.
Skill Claude CodeCodex
Use when creating or modifying database schema in Zolinga modules, including install SQL and update migration scripts with naming conventions.
Skill Claude CodeCodex
Use when you need to inspect database schema, list tables, view table structure, or run read-only SELECT queries for debugging purposes using the mysql CLI.
Skill Claude CodeCodex
ALWAYS use when writing or updating ANY wiki documentation in this repository. Mandatory for all wiki changes. Guides a user-oriented writing style focused on tasks and outcomes. Enforces the no-duplication rule: reference existing content rather than repeating it.
Skill Claude CodeCodex
Use when working with the JavaScript client-side event system in Zolinga. Covers the Event class, Api gateway, dispatching events from JS to PHP, receiving broadcastBack responses, inter-component communication via BroadcastChannel, and web component integration.
Skill Claude CodeCodex
Use when creating, dispatching, or handling PHP server-side events in Zolinga. Covers event class hierarchy, status/message access, origin types, stoppable events, authorization, manifest wiring, and common pitfalls.
Skill Claude CodeCodex
Use when writing localizable PHP code in Zolinga modules — dgettext/dngettext usage, domain naming, and context separators.
Skill Claude CodeCodex
How to query the Zolinga system's runtime state — merged manifest cache, API service stubs, configuration layers, and log files — using jq, grep, tail, and PHP.