adk

What This Skill Does

The Botpress Agent Development Kit (ADK) skill is your primary companion for building AI-native bots using the Botpress TypeScript framework. Unlike traditional chatbot builders that rely on rigid intent matching and dialog flows, the ADK uses an AI-first approach where file structure dictates bot behavior. This skill provides an interactive guide to the framework's conventions, helping you map your requirements to the correct ADK components—such as tools, actions, tables, and conversations—ensuring your code follows the framework's strict directory-based architecture. It helps you navigate the entire development lifecycle, from initializing your project via the ADK CLI to deploying your finished agent.

Installation

To integrate this expert guide into your workspace, run the following command in your terminal: clawhub install openclaw/skills/skills/yueranlu/botpress-adk

Use Cases

Use this skill whenever you are:

• Architecting a new AI agent from scratch.
• Troubleshooting directory structure errors (e.g., misplacing an action in the tools folder).
• Developing custom AI tools to extend agent capabilities.
• Managing structured state using internal tables.
• Integrating external services like Slack, WhatsApp, or proprietary APIs.
• Debugging deployment failures via the ADK CLI.

Example Prompts

1. "I need to create an AI bot that checks user orders from a database; how do I set up a table and a tool for this in ADK?"
2. "My bot isn't responding correctly to user messages. Can you help me check if my conversation logic in src/conversations/ is structured correctly?"
3. "How do I use the ADK CLI to deploy my current bot to the Botpress cloud environment?"

Tips & Limitations

• Convention over Configuration: Always respect the src/ subdirectory mapping. Placing a file in the wrong directory will result in the ADK failing to discover your component.
• No Intents: Forget about intents or entities. Rely on the AI's natural language understanding and your well-defined tool descriptions to handle complex user requests.
• CLI First: Keep adk --help handy. The CLI is your main tool for scaffolding and lifecycle management.
• TypeScript Strong Typing: ADK is built on TypeScript; ensure your code definitions match the expected interfaces to avoid runtime errors in the Agent runtime.