🧩 Skills Reference

Skills Summary

Discord (29 tools)

Core Discord messaging and channel interactions: send messages, manage embeds, reactions, threads, forum posts, polls, and crosspost to announcement channels.

Moderation (11 tools)

Server moderation toolkit: kick, ban, timeout, warn members, purge messages, and control slowmode. Destructive actions (kick, ban) require approval via the security observer.

Server Management (21 tools)

Comprehensive server administration: manage emojis, invites, auto-roles, welcome messages, scheduled events, webhooks, and channel permissions.

User Management (6 tools)

Manage server members: look up user info, assign and remove roles, change nicknames, send DMs, and list members with filters.

Components (6 tools)

Interactive Discord UI components: send messages with buttons and select menus, set up reaction roles for self-service role assignment.

Memory (1 tool)

Search and browse structured bot logs stored in SQLite for debugging and auditing.

Semantic Memory (5 tools)

Persistent long-term memory powered by FTS5 full-text search. Store facts, preferences, events, relationships, and decisions that persist across conversations.

Discord Search (9 tools)

Advanced message searching: keyword search, user history, conversation context, channel activity, deleted message auditing, semantic search via AI embeddings, and message edit tracking.

Integrations (17 tools)

Connect to external services: register and call custom APIs, subscribe to RSS/Atom feeds, create inbound webhook endpoints, and interact with GitHub repositories.

Email (3 tools)

OpenMail integration with owner-gated approval. Only pre-approved email threads are accessible to the LLM for privacy and security.

Voice (13 tools)

Full voice and audio suite: text-to-speech, speech-to-text transcription, voice channel management, meeting transcription mode, and an interactive voice assistant with wake-word detection.

Agent System (7 tools)

Create and manage specialized agents: persistent personas with custom system prompts, tool access, and trigger words. Agents can be invoked, handed-over to, and toggled on/off.

Sub-Agents (7 tools)

Spawn temporary background sub-agents for complex multi-step tasks. Includes a task board for tracking work items and assigning them to sub-agents.

Workflows (9 tools)

DAG-based workflow automation: create directed graphs of triggers, conditions, actions, transforms, and control-flow nodes. Workflows execute on events and can be manually triggered.

Event System (13 tools)

Event-driven automations: listen for Discord events, external WebSocket messages, REST API changes, and cron triggers. React with messages, AI responses, tool calls, or webhook forwards.

Graph Renderer (1 tool)

Generate beautiful dark-mode chart images from structured data. Supports 20 chart types: line, bar, horizontal bar, pie, donut, area, scatter, radar, gauge, progress, funnel, heatmap, treemap, waterfall, candlestick, timeline, histogram, sparkline, sankey, and polar area.

Cron (4 tools)

Schedule recurring tasks with cron expressions: create, list, delete, and toggle cron jobs that run actions on a defined schedule.

Utility (5 tools)

General-purpose utilities: send rich embeds, create native Discord polls, set timed reminders, fetch URL content, and search the web.

System (5 tools)

System-level tools: execute allowlisted commands, download files, restart the bot, check API credit balance, and view cache statistics.

Table Renderer (1 tool)

Render markdown tables as dark-mode PNG images for clean display in Discord. Supports emoji, long text wrapping, and automatic column sizing.

Skill Manager (5 tools)

Manage user-defined skills at runtime: create, read, edit, and delete custom skills stored in the skills/ directory. Skills are hot-loaded without restarting the bot.

Skill Agent (1 tool)

AI-powered skill generator: describe what you want and the LLM generates a complete skill with tool definitions and execute logic.

Image Generation (1 tool)

Generate images from text prompts using AI models via OpenRouter. Supports optional reference images for style or composition guidance.

Custom Skills

VexAI supports user-defined skills that extend the bot's capabilities without modifying the core codebase. Custom skills are hot-loaded from the skills/ directory at startup and can be managed at runtime.

How Custom Skills Work

• Skills are loaded from the skills/ directory in the project root
• Each skill lives in its own subdirectory with a JavaScript entry file
• Skills follow the registry pattern: name, description, tools[], and execute(toolName, args, context)
• The SkillContext provides channelId, userId, guildId, client, and executeTool() for internal tool calls
• Internal tool calls via executeTool() have a max recursion depth of 5 and bypass the security observer

Managing Custom Skills

Use the skill-manager tools to create, edit, delete, and list custom skills at runtime. Use the skill-agent to generate complete skill code from a natural-language description.

Skill Structure

{
  "name": "my-custom-skill",
  "description": "What this skill does",
  "tools": [
    {
      "name": "my_tool",
      "description": "What this tool does",
      "parameters": {
        "type": "object",
        "properties": {
          "input": { "type": "string", "description": "Input parameter" }
        },
        "required": ["input"]
      }
    }
  ]
}