adk

Botpress Skills

A collection of skills for AI coding agents building with Botpress. Skills are packaged instructions and documentation that extend agent capabilities for Botpress development.

Skills follow the Agent Skills format.

Available Skills

botpress-adk

Comprehensive documentation and guidelines for building AI agents with the Botpress Agent Development Kit (ADK). A convention-based TypeScript framework where file structure maps directly to bot behavior.

Use when:

• Building new features with the Botpress ADK
• Working with Actions, Tools, or Workflows
• Implementing data storage (Tables, Files, Knowledge Bases)
• Using Zai for AI operations (extract, check, label, summarize)
• Configuring integrations or bot settings
• Setting up event-driven triggers
• Need CLI commands or MCP server setup

Categories covered:

• Core Concepts - Actions (strongly-typed functions), Tools (AI-callable), Workflows (long-running processes), Conversations (message handlers), Triggers (event-driven automation)
• Data & Content - Tables (structured storage with semantic search), Files (file storage and management), Knowledge Bases (RAG implementation)
• AI Features - Zai (production-ready LLM utility library for common AI operations)
• Configuration - Agent config, integration actions, context API, environment variables
• Development Tools - CLI reference, MCP server integration, project structure best practices

botpress-adk-frontend

Production-tested patterns for building frontend applications that integrate with Botpress ADK bots. Covers authentication, type-safe API calls, client management, and type generation workflows.

Use when:

• Building a frontend that connects to a Botpress bot
• Implementing authentication with Personal Access Tokens (PATs)
• Setting up the @botpress/client
• Calling bot actions from React/Next.js
• Generating and using TypeScript types from your bot
• Managing client state and caching
• Handling errors and optimistic updates

Categories covered:

• Authentication - Cookie-based PAT storage, OAuth flow, route protection, token management
• Client Management - Zustand store patterns, client caching and reuse, workspace vs bot-scoped clients
• Type Generation - Triple-slash references, importing generated types, type-safe action calls
• Action Calls - React Query patterns, error handling, optimistic updates, proper typing

Key technologies:

• @botpress/client (official TypeScript client)
• TypeScript triple-slash references
• React Query (optional, recommended for mutations)
• Zustand (for client state management)

botpress-adk-evals

Complete reference for writing, running, and iterating on evals (automated conversation tests) for ADK agents. Covers eval file format, all assertion types, CLI usage, and per-primitive testing patterns.

Use when:

• Writing automated tests for an ADK agent
• Learning the eval file format and assertion types
• Running evals and interpreting results
• Testing specific primitives (actions, tools, workflows, conversations, tables)
• Integrating evals into CI pipelines

Categories covered:

• Eval Format - File structure, turn types, all assertion categories (response, tools, state, tables, workflow, timing)
• Testing Workflow - Running evals, interpreting output, using traces, the write-test-iterate loop
• Test Patterns - Per-primitive testing patterns for actions, tools, workflows, conversations, tables, and state

botpress-adk-integrations

Discovering, adding, configuring, and using Botpress integrations in ADK projects. Covers the full integration lifecycle from search to production use.

Use when:

• Searching for available integrations
• Adding an integration to an ADK project
• Configuring integration credentials and settings
• Using integration actions, events, and channels in code
• Troubleshooting integration issues

Categories covered:

• Discovery - adk search, adk list --available, adk info for exploring the integration hub
• Lifecycle - End-to-end workflow from search to production use
• Configuration - Config types (no-config, OAuth, API key), agent.config.ts setup
• Common Integrations - Quick reference for Slack, WhatsApp, Linear, and more

botpress-adk-docs

Guidelines and commands for creating, reviewing, updating, and maintaining documentation for your ADK bot. Helps you document your own workflows, actions, and features with accurate, searchable guides.

Use when: