Portable Agent Skills for developing MikoPBX modules and customizing
MikoPBX itself with AI coding agents. Every skill is a SKILL.md folder that works without
modification in Claude Code, OpenAI Codex, Gemini CLI, Cursor, GitHub Copilot, OpenCode and any
other agent that implements the open standard.
The skills were extracted from the private tooling used by the MikoPBX core team. They contain the same hook references, recipes, anti-patterns and validation scripts the team uses in daily work.
With the skills CLI:
# interactive: pick skills and agents
npx skills add mikopbx/agent-skills
# everything, for every agent detected on this machine, no prompts
npx skills add mikopbx/agent-skills --all
# specific agents, project-local
npx skills add mikopbx/agent-skills -a claude-code -a codex
# user-wide instead of the current project
npx skills add mikopbx/agent-skills -gManual install: copy the folders you need from skills/ into your agent's skills directory
(.claude/skills/, .codex/skills/, .agents/skills/, .cursor/skills/, ...). Each skill is
self-contained.
| Skill | Use it when |
|---|---|
mikopbx-module |
Creating or extending a MikoPBX extension module: structure, hooks, forms, REST endpoints, workers, translations, packaging. The main skill. |
api-client |
Calling the MikoPBX REST API v3 with automatic authentication, from the host or inside the dev container. |
endpoint-validator |
Checking a REST endpoint implementation against its OpenAPI schema and data structure. |
openapi-analyzer |
Extracting and inspecting the OpenAPI 3.1 specification served by a running MikoPBX. |
api-test-generator |
Generating pytest suites for REST endpoints with schema validation. |
sqlite-inspector |
Verifying data in the MikoPBX SQLite databases after API or module operations. |
log-analyzer |
Reading and correlating MikoPBX logs (system, PHP, Asterisk, nginx, fail2ban). |
asterisk-validator |
Validating generated Asterisk configuration files and Asterisk logs. |
asterisk-tester |
Running dialplan and call-flow scenarios against a MikoPBX instance. |
babel-compiler |
Transpiling ES6+ admin-interface JavaScript to the ES5 bundle MikoPBX ships. |
translations |
Managing the multilingual UI message files with Russian as the source language. |
Most skills assume a MikoPBX checkout (mikopbx/Core) and a
running MikoPBX instance, either the development Docker container or a real PBX reachable over
SSH. Each SKILL.md states what it needs.
- Developer documentation: https://github.com/mikopbx/DevelopementDocs
- Module template: https://github.com/mikopbx/ModuleTemplate
- MikoPBX core: https://github.com/mikopbx/Core
GPL-3.0-or-later, the same license as MikoPBX.