{"id":47998219,"url":"https://github.com/botpress/skills","last_synced_at":"2026-04-04T12:07:40.562Z","repository":{"id":334274299,"uuid":"1139266821","full_name":"botpress/skills","owner":"botpress","description":"A collection of skills for AI coding agents building with Botpress. Skills are packaged instructions and documentation that extend agent capabilities for Botpress development.","archived":false,"fork":false,"pushed_at":"2026-03-27T15:26:09.000Z","size":350,"stargazers_count":8,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-03-28T00:43:23.769Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://botpress.com","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/botpress.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-21T18:32:13.000Z","updated_at":"2026-03-27T15:26:10.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/botpress/skills","commit_stats":null,"previous_names":["botpress/skills"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/botpress/skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/botpress%2Fskills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/botpress%2Fskills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/botpress%2Fskills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/botpress%2Fskills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/botpress","download_url":"https://codeload.github.com/botpress/skills/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/botpress%2Fskills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31398810,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T10:20:44.708Z","status":"ssl_error","status_checked_at":"2026-04-04T10:20:06.846Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-04T12:07:40.012Z","updated_at":"2026-04-04T12:07:40.553Z","avatar_url":"https://github.com/botpress.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003cpicture\u003e\n        \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"./assets/dark.png\"\u003e\n        \u003cimg src=\"./assets/light.png\"\u003e\n    \u003c/picture\u003e\n\u003c/p\u003e\n\n# Botpress Skills\n\nA collection of skills for AI coding agents building with Botpress. Skills are packaged instructions and documentation that extend agent capabilities for Botpress development.\n\nSkills follow the [Agent Skills](https://agentskills.io/) format.\n\n## Available Skills\n\n### botpress-adk\n\nComprehensive 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.\n\n**Use when:**\n\n- Building new features with the Botpress ADK\n- Working with Actions, Tools, or Workflows\n- Implementing data storage (Tables, Files, Knowledge Bases)\n- Using Zai for AI operations (extract, check, label, summarize)\n- Configuring integrations or bot settings\n- Setting up event-driven triggers\n- Need CLI commands or MCP server setup\n\n**Categories covered:**\n\n- **Core Concepts** - Actions (strongly-typed functions), Tools (AI-callable), Workflows (long-running processes), Conversations (message handlers), Triggers (event-driven automation)\n- **Data \u0026 Content** - Tables (structured storage with semantic search), Files (file storage and management), Knowledge Bases (RAG implementation)\n- **AI Features** - Zai (production-ready LLM utility library for common AI operations)\n- **Configuration** - Agent config, integration actions, context API, environment variables\n- **Development Tools** - CLI reference, MCP server integration, project structure best practices\n\n### botpress-adk-frontend\n\nProduction-tested patterns for building frontend applications that integrate with Botpress ADK bots. Covers authentication, type-safe API calls, client management, and type generation workflows.\n\n**Use when:**\n\n- Building a frontend that connects to a Botpress bot\n- Implementing authentication with Personal Access Tokens (PATs)\n- Setting up the @botpress/client\n- Calling bot actions from React/Next.js\n- Generating and using TypeScript types from your bot\n- Managing client state and caching\n- Handling errors and optimistic updates\n\n**Categories covered:**\n\n- **Authentication** - Cookie-based PAT storage, OAuth flow, route protection, token management\n- **Client Management** - Zustand store patterns, client caching and reuse, workspace vs bot-scoped clients\n- **Type Generation** - Triple-slash references, importing generated types, type-safe action calls\n- **Action Calls** - React Query patterns, error handling, optimistic updates, proper typing\n\n**Key technologies:**\n\n- @botpress/client (official TypeScript client)\n- TypeScript triple-slash references\n- React Query (optional, recommended for mutations)\n- Zustand (for client state management)\n\n## Installation\n\n```bash\nnpx skills add botpress/skills --skill adk\n```\n\n## Usage\n\nSkills are automatically available once installed. The agent will use them when relevant tasks are detected.\n\n**Examples:**\n\n```\nCreate an Action that fetches user data\n```\n\n```\nHow do I use Zai to extract structured data?\n```\n\n```\nShow me how to call my bot's actions from a Next.js frontend\n```\n\n```\nSet up authentication for my React app with Botpress\n```\n\n## Skill Structure\n\nEach skill contains:\n\n- `SKILL.md` - Instructions for the agent\n- `references/` - Supporting documentation files\n\n```\nskills/\n├── adk/\n│   ├── SKILL.md\n│   └── references/\n│       ├── actions.md\n│       ├── tools.md\n│       ├── workflows.md\n│       └── ...\n└── adk-frontend/\n    ├── SKILL.md\n    └── references/\n        ├── authentication.md\n        ├── botpress-client.md\n        ├── calling-actions.md\n        └── type-generation.md\n```\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbotpress%2Fskills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbotpress%2Fskills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbotpress%2Fskills/lists"}