opensips-skills
Claude Code plugin providing two coordinated Agent Skills for working with OpenSIPs.
What this is
OpenSIPs is twenty years old and runs some of the world's most demanding real-time communication infrastructure — carrier networks, contact centers, CPaaS platforms, enterprise PBXes. It has hundreds of modules, a domain-specific scripting language, and documentation that spans thousands of pages across multiple versions. Ask any general-purpose LLM to write you an opensips.cfg and the result looks right and is subtly broken: a parameter name from the wrong version, a function signature borrowed from a sibling SER-lineage project, a pseudo-variable that does not exist. The output compiles, runs, and fails in production.
This is a knowledge problem, not a model problem. Training data conflates OpenSIPs with other projects descending from the SIP Express Router (SER) lineage and conflates syntax across versions that have drifted over two decades. Without a grounded reference, the model has no way to tell the difference. opensips-skills solves this by grounding Claude in version-specific, OpenSIPs-authoritative documentation. Every function signature, parameter, pseudo-variable, MI command, and module dependency is mirrored from upstream extraction and rendered as Markdown reference files Claude reads on demand.
The plugin ships two coordinated skills that load together. opensips-config is the single entry point for OpenSIPs configuration work — authoring and editing opensips.cfg route scripts, looking up module exports, and answering questions about cfg syntax. It owns the loadmodule-scan workflow: read cfg-format.md, scan consolidated.json, then read each loaded module's per-module reference before answering. opensips-security-advisor reviews configs for security issues; it ships in v1 as a scaffold with a stable trigger surface, and substantive review patterns are authored by a separate agent post-v1.
Version coverage is dynamic. As of this release the plugin covers OpenSIPs 3.5 and 3.6, with 3.4 source data committed but blocked by a known upstream defect. New versions arrive by dropping a folder under data/ — no code change required.
The audience this is built for: SIP and VoIP engineers who already know OpenSIPs — carriers, ITSPs, contact centers, CPaaS operators — and want a pair programmer that produces a working request_route in sixty seconds instead of twenty minutes, without the silent bugs that come from LLM hallucination. A secondary audience is engineers new to OpenSIPs who want to try it: every answer cites a real reference file they can read themselves, so the plugin doubles as a guided experience.
Install
The plugin runs inside Claude Code. The two install paths:
# Via the Claude Code plugin marketplace (once published)
/plugin marketplace add VoicenterTeam/opensips-skills
/plugin install opensips@opensips-skills
# Or, locally for development
claude --plugin-dir /path/to/opensips-skills/plugins/opensips
After installation, run /skills inside Claude Code to confirm opensips-config and opensips-security-advisor are both listed. The skills do not need to be invoked by name — they activate automatically when prompts mention OpenSIPs concerns. There is no per-version install step; the plugin ships every supported version's reference tree in one package and resolves the active version from the prompt at trigger time.
Quick example
Prompt:
"I'm on OpenSIPs 3.6. Write me a request_route that loads tm and registrar, authenticates inbound REGISTER via auth_db, and stores location. Then audit it for missing rate limits."
What happens behind the scenes:
opensips-config activates because the prompt names opensips.cfg concerns and a route block. It follows the loadmodule-scan workflow: reads references/3.6/cfg-format.md to ground in the cfg structure, reads references/3.6/consolidated.json for the module index, then reads references/3.6/modules/tm.md, references/3.6/modules/registrar.md, and references/3.6/modules/auth_db.md to ground the function signatures, plus references/3.6/core/variables.md for the pseudo-variable list. For example, the skill confirms that www_authorize (not www_authenticate from a sibling project) is the OpenSIPs name, and that auth_db.calculate_ha1 takes an integer (1), not the boolean keyword some sibling projects accept.opensips-security-advisor activates on the "audit" cue, flags the missing flood-protection module, and points to references/3.6/modules/pike.md and references/3.6/modules/ratelimit.md for the remediation.
