Skills & Agents

xbot supports extensible skills and role-based sub-agents, both defined as Markdown files.

Skills are Markdown-based capability packages that provide specialized instructions for specific tasks. They are loaded from the workspace on demand.

Each skill is a directory under ~/.xbot/skills/ (or embedded in the binary):

~/.xbot/skills/
└── my-skill/
    └── SKILL.md       # Main skill definition

The agent discovers and loads skills via the Skill tool:

Skill(name="debug", action="load")

SubAgents are role-based sub-programs that can be delegated tasks. They run independently with their own tool set and context.

Each agent is a Markdown file under ~/.xbot/agents/ (or embedded):

~/.xbot/agents/
├── explore.md         # Code exploration agent
├── chancellery.md     # Review agent
├── secretariat.md     # Planning agent
└── ...

One-shot (default):

SubAgent(task="review this code", role="chancellery")

Interactive (multi-turn session):

SubAgent(task="analyze this module", role="explore", interactive=true, instance="review-1")
SubAgent(task="now check the tests", role="explore", action="send", instance="review-1")
SubAgent(task="", role="explore", action="unload", instance="review-1")

• Max nesting depth: 6 (MAX_SUBAGENT_DEPTH)
• Parallel instances: supported via unique instance IDs

Users can publish, browse, install, and uninstall skills and agents through the marketplace (Web channel and slash commands).