API Reference
Aigentic provides APIs for developers who want to build custom skills, integrate with the agent messaging system, or automate agent interactions.
Available APIs
Section titled “Available APIs”Skill API
Section titled “Skill API”The Skill API defines how to build skills that extend agent capabilities. It covers:
- SKILL.md format — How to describe your skill’s metadata, permissions, and configuration.
- Tool definitions — How to define new tools that agents can invoke.
- SkillForge — How to use AI-powered skill generation.
The Skill API is the primary way to extend Aigentic. If you want agents to interact with a new service, process new types of data, or perform custom workflows, you build a skill.
Read the Skill API documentation
Gateway WebSocket Protocol
Section titled “Gateway WebSocket Protocol”The Gateway WebSocket Protocol defines how clients communicate with agents through the gateway. It covers:
- Connection flow — How to establish a WebSocket connection.
- Message types — The different message formats for chat, streaming, tool invocations, and errors.
- Authentication — How connections are authenticated.
- Event model — How events flow between clients, the gateway, and agents.
The Gateway WebSocket Protocol is useful for building custom frontends, integrations, or automation that interacts with agents outside of the Aigentic console.
Read the Gateway WebSocket Protocol documentation
When to Use Each API
Section titled “When to Use Each API”| Goal | API |
|---|---|
| Add a new tool to agents | Skill API |
| Integrate with a third-party service | Skill API |
| Build a multi-step workflow | Skill API |
| Build a custom chat interface | Gateway WebSocket Protocol |
| Automate agent interactions from scripts | Gateway WebSocket Protocol |
| Monitor agent activity programmatically | Gateway WebSocket Protocol |
API Stability
Section titled “API Stability”Both APIs follow semantic versioning. Breaking changes are only introduced in major version bumps with advance deprecation notices.
| API | Version | Status |
|---|---|---|
| Skill API | v1 | Stable |
| Gateway WebSocket Protocol | v1 | Stable |
Development Resources
Section titled “Development Resources”- SkillForge — Use AI to generate complete skill packages from plain English descriptions.
- ClawHub catalog — Browse published skills for reference implementations.
- Community — Follow us and share your work on X.