MikoPBX Agent Skills

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.

Install

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 -g

Manual 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.

Skills

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.

Prerequisites

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.

Related

• Developer documentation: https://github.com/mikopbx/DevelopementDocs
• Module template: https://github.com/mikopbx/ModuleTemplate
• MikoPBX core: https://github.com/mikopbx/Core

License

GPL-3.0-or-later, the same license as MikoPBX.