Add Example Agent
GetBindu/Bindu
Add a new self-contained example agent under examples/. An agent skill from GetBindu/Bindu.
Build and deploy AI agents with Cloudbase Agent (TypeScript), a TypeScript SDK implementing the AG-UI protocol.
Install Cloudbase Agent
$ npx skills add TencentCloudBase/CloudBase-AI-Toolkit --skill cloudbase-agent -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install TencentCloudBase/CloudBase-AI-Toolkit cloudbase-agent --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/TencentCloudBase/CloudBase-AI-Toolkit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/config/source/skills/cloudbase-agent/ts .claude/skills/cloudbase-agent && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "cloudbase-agent" agent skill from https://github.com/TencentCloudBase/CloudBase-AI-Toolkit/tree/main/config/source/skills/cloudbase-agent/ts into .claude/skills/cloudbase-agent/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cloudbase-agent", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/TencentCloudBase/CloudBase-AI-Toolkit/tree/main/config/source/skills/cloudbase-agent/tsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add TencentCloudBase/CloudBase-AI-Toolkit --skill cloudbase-agent -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install TencentCloudBase/CloudBase-AI-Toolkit cloudbase-agent --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/TencentCloudBase/CloudBase-AI-Toolkit.git skills-src && mkdir -p .agents/skills && cp -r skills-src/config/source/skills/cloudbase-agent/ts .agents/skills/cloudbase-agent && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "cloudbase-agent" agent skill from https://github.com/TencentCloudBase/CloudBase-AI-Toolkit/tree/main/config/source/skills/cloudbase-agent/ts into .agents/skills/cloudbase-agent/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cloudbase-agent", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add TencentCloudBase/CloudBase-AI-Toolkit --skill cloudbase-agent -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install TencentCloudBase/CloudBase-AI-Toolkit cloudbase-agent --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/TencentCloudBase/CloudBase-AI-Toolkit.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/config/source/skills/cloudbase-agent/ts .cursor/skills/cloudbase-agent && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "cloudbase-agent" agent skill from https://github.com/TencentCloudBase/CloudBase-AI-Toolkit/tree/main/config/source/skills/cloudbase-agent/ts into .cursor/skills/cloudbase-agent/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cloudbase-agent", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/TencentCloudBase/CloudBase-AI-Toolkit.git --path config/source/skills/cloudbase-agent/ts--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add TencentCloudBase/CloudBase-AI-Toolkit --skill cloudbase-agent -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install TencentCloudBase/CloudBase-AI-Toolkit cloudbase-agent --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/TencentCloudBase/CloudBase-AI-Toolkit.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/config/source/skills/cloudbase-agent/ts .gemini/skills/cloudbase-agent && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "cloudbase-agent" agent skill from https://github.com/TencentCloudBase/CloudBase-AI-Toolkit/tree/main/config/source/skills/cloudbase-agent/ts into .gemini/skills/cloudbase-agent/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cloudbase-agent", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install TencentCloudBase/CloudBase-AI-Toolkit cloudbase-agentInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add TencentCloudBase/CloudBase-AI-Toolkit --skill cloudbase-agent -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/TencentCloudBase/CloudBase-AI-Toolkit.git skills-src && mkdir -p .github/skills && cp -r skills-src/config/source/skills/cloudbase-agent/ts .github/skills/cloudbase-agent && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "cloudbase-agent" agent skill from https://github.com/TencentCloudBase/CloudBase-AI-Toolkit/tree/main/config/source/skills/cloudbase-agent/ts into .github/skills/cloudbase-agent/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cloudbase-agent", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add TencentCloudBase/CloudBase-AI-Toolkit --skill cloudbase-agent -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install TencentCloudBase/CloudBase-AI-Toolkit cloudbase-agent --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/TencentCloudBase/CloudBase-AI-Toolkit.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/config/source/skills/cloudbase-agent/ts .opencode/skills/cloudbase-agent && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "cloudbase-agent" agent skill from https://github.com/TencentCloudBase/CloudBase-AI-Toolkit/tree/main/config/source/skills/cloudbase-agent/ts into .opencode/skills/cloudbase-agent/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cloudbase-agent", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
cloudbase-agent- GitHub stars
- 1.1k
- Used in
- 3 other repos
- Token cost
- ~947 tokens
- SKILL.md length
- 313 words
- Files
- 9
- Skills in repo
- 49
- Repo updated
- First seen
- Licence
- MIT
At a glance
Build and deploy AI agents with Cloudbase Agent (TypeScript), a TypeScript SDK implementing the AG-UI protocol.
- Works in 4 steps: Choose the right adapter → Deploy the agent server → Build the UI client → …
- Deploying agent servers with @cloudbase/agent-server
- SKILL.md covers When to use this skill, How to use this skill (for a…, Routing and Quick Start
- Calls npm
What it does
Cloudbase Agent is an agent skill from TencentCloudBase/CloudBase-AI-Toolkit. Build and deploy AI agents with Cloudbase Agent (TypeScript), a TypeScript SDK implementing the AG-UI protocol. Use when: (1) deploying agent servers with @cloudbase/agent-server, (2) using LangGraph adapter with ClientStateAnnotation, (3) using LangChain adapter with clientTools(), (4) building custom adapters that implement AbstractAgent, (5) understanding AG-UI protocol events, (6) building web UI clients with @ag-ui/client, (7) building WeChat Mini Program UIs with @cloudbase/agent-ui-miniprogram.
Its SKILL.md is about 950 tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files (for example `adapter-development.md`, `adapter-langchain.md` and `adapter-langgraph.md`).
It sits in AI & LLM Engineering, covering Building AI agents and Frontend development. It works with WeChat, TypeScript, LangGraph and LangChain. The repository describes itself as: Backend for AI coding agents on CloudBase — database, auth, functions via Plugin, Skills & MCP. The licence is MIT.
When your agent uses it
- Deploying agent servers with @cloudbase/agent-server
- Using LangGraph adapter with ClientStateAnnotation
- Using LangChain adapter with clientTools()
- Building custom adapters that implement AbstractAgent
Example prompts
- “/cloudbase-agent”
Requirements
- Node.js
Workflow steps
4 steps, taken from the first numbered list in SKILL.md.
- Choose the right adapter
- Deploy the agent server
- Build the UI client
- Follow the routing table below to find detailed documentation for each task
What it can do on your machine
Read from SKILL.md and the folder at commit ea2c202. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
npm
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Cloudbase Agent loads about 947 tokens when it runs. Until then it costs about 131 tokens; SKILL.md has 313 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from TencentCloudBase/CloudBase-AI-Toolkit at commit ea2c202, republished under its MIT licence (© TencentCloudBase). 313 words, ~947 tokens.
Download SKILL.mdSave it as
.claude/skills/cloudbase-agent/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.- name
- cloudbase-agent
- description
- Build and deploy AI agents with Cloudbase Agent (TypeScript), a TypeScript SDK implementing the AG-UI protocol. Use when: (1) deploying agent servers with @cloudbase/agent-server, (2) using LangGraph adapter with ClientStateAnnotation, (3) using LangChain adapter with clientTools(), (4) building custom adapters that implement AbstractAgent, (5) understanding AG-UI protocol events, (6) building web UI clients with @ag-ui/client, (7) building WeChat Mini Program UIs with @cloudbase/agent-ui-miniprogram.
- version
- 2.34.8
- alwaysApply
- true
Cloudbase Agent (TypeScript)
TypeScript SDK for deploying AI agents as HTTP services using the AG-UI protocol.
Note: This skill is for TypeScript/JavaScript projects only.
When to use this skill
Use this skill for AI agent development when you need to:
- Deploy AI agents as HTTP services with AG-UI protocol support
- Build agent backends using LangGraph or LangChain frameworks
- Create custom agent adapters implementing the AbstractAgent interface
- Understand AG-UI protocol events and message streaming
- Build web UI clients that connect to AG-UI compatible agents
- Build WeChat Mini Program UIs for AI agent interactions
Do NOT use for:
- Simple AI model calling without agent capabilities (use
ai-model-*skills) - CloudBase cloud functions (use
cloud-functionsskill) - CloudRun backend services without agent features (use
cloudrun-developmentskill)
How to use this skill (for a coding agent)
Choose the right adapter
- Use LangGraph adapter for stateful, graph-based workflows
- Use LangChain adapter for chain-based agent patterns
- Build custom adapter for specialized agent logic
Deploy the agent server
- Use
@cloudbase/agent-serverto expose HTTP endpoints - Configure CORS, logging, and observability as needed
- Prefer deploying to CloudBase using
manageAgentMCP tool (see agent-deployment) - Before deploy, read Dependency Alignment Policy in agent-deployment to avoid cloud build dependency errors
- Use
Build the UI client
- Use
@ag-ui/clientfor web applications - Use
@cloudbase/agent-ui-miniprogramfor WeChat Mini Programs - Connect to the agent server's
/send-messageor/aguiendpoints
- Use
Follow the routing table below to find detailed documentation for each task
Routing
| Task | Read |
|---|---|
| Deploy agent to CloudBase (read this first) | agent-deployment |
| Deploy agent server (@cloudbase/agent-server) | server-quickstart |
| Use LangGraph adapter | adapter-langgraph |
| Use LangChain adapter | adapter-langchain |
| Build custom adapter | adapter-development |
| Understand AG-UI protocol | agui-protocol |
| Build UI client (Web or Mini Program) | ui-clients |
| Deep-dive @cloudbase/agent-ui-miniprogram | ui-miniprogram |
Quick Start
Prerequisites: Node.js >= 20 is required.
1. Install dependencies:
npm install @cloudbase/agent-server@latest @cloudbase/agent-adapter-langgraph@latestCritical: Always use @latest for all @cloudbase/agent-* packages. For dependency version rules, see Dependency Alignment Policy in agent-deployment.md.
2. Create and run your agent:
import { run } from "@cloudbase/agent-server";
import { LanggraphAgent } from "@cloudbase/agent-adapter-langgraph";
run({
createAgent: () => ({ agent: new LanggraphAgent({ workflow }) }),
port: 9000,
});© TencentCloudBase, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 8 other files in config/source/skills/cloudbase-agent/ts of TencentCloudBase/CloudBase-AI-Toolkit.
- SKILL.md
- adapter-development.md
- adapter-langchain.md
- adapter-langgraph.md
- agent-deployment.md
- agui-protocol.md
- server-quickstart.md
- ui-clients.md
- ui-miniprogram.md
Open the folder on GitHubat commit ea2c202
Used in 3 other repositories
We found 8 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 3 other GitHub owners. This page covers the copy in TencentCloudBase/CloudBase-AI-Toolkit, which our catalogue first saw on October 7, 2026.
Compare with similar skills
Cloudbase Agent next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Cloudbase Agent this skillTencentCloudBase/CloudBase-AI-Toolkit | 1.1k | 3 repos | ~947 | Automated safety check: Pass | MIT | |
| Add Example AgentGetBindu/Bindu | 10k | — | ~1.1k | Automated safety check: Notes | Custom licence | |
| Failproof AI SDK IntegrationFailproofAI/failproofai | 5.3k | — | ~6k | Automated safety check: Pass | Custom licence | |
| Agent Inspectrajudandigam/agent-inspect | 165 | — | ~424 | Automated safety check: Pass | MIT | |
| Deep Agents Corelangchain-ai/langchain-skills | 1.3k | 1 repos | ~3.1k | Automated safety check: Pass | MIT | |
| Tool Designagentailor/fullstack-langgraph-nextjs-agent | 132 | — | ~3.2k | Automated safety check: Pass | MIT |
Similar skills
Failproof AI SDK Integration
FailproofAI/failproofai
Helps instrument a custom Python or TypeScript agent to record events for Failproof AI, verify what gets written, and run an evaluator worker that scores the runs.
Agent Inspect
rajudandigam/agent-inspect
Local evidence debugger and trajectory-test toolkit for TypeScript AI agents.
- Official
Deep Agents Core
langchain-ai/langchain-skills
Explains how to build agents with the Deep Agents framework: create_deep_agent, the built-in middleware, the harness, SKILL.md format and configuration options.
Tool Design
agentailor/fullstack-langgraph-nextjs-agent
Design and verify tools that AI agents can actually use — for any framework or language (MCP servers, LangChain/LangGraph, function-calling, raw JSON schema; TypeScript, Python, or otherwise).
- Official
Docs Code Samples
langchain-ai/docs
A skill your agent uses when migrating inline code samples from LangChain docs (MDX files) into external, testable code files that are extracted by this repo’s snippet scripts and used as Mintlify…
More from TencentCloudBase/CloudBase-AI-Toolkit
All 49 skills in this repoAI Model Nodejs
TencentCloudBase/CloudBase-AI-Toolkit
A skill your agent uses for Node.js backend AI via @cloudbase/node-sdk (=3.16.0) — cloud functions, CloudRun, Express/Koa/NestJS, serverless APIs, scheduled jobs, LLM proxies, agent orchestration.
HTTP API Cloudbase
TencentCloudBase/CloudBase-AI-Toolkit
CloudBase official HTTP API client guide. An agent skill from TencentCloudBase/CloudBase-AI-Toolkit.
Cloud API Recipe Authoring
TencentCloudBase/CloudBase-AI-Toolkit
Author or revise a cloud-api-operations recipe (config/source/skills/cloud-api-operations/references/recipes/).
Manage Local Skills
TencentCloudBase/CloudBase-AI-Toolkit
Analyze, standardize, validate, and sync locally maintained skills into agent skill directories with a skills CLI-aligned workflow.
Cloudbase Agent Python
TencentCloudBase/CloudBase-AI-Toolkit
Build production-ready AI agent backends using the CloudBase Agent Python SDK — create agents with LangGraph/CrewAI/LlamaIndex, serve them via FastAPI with AG-UI protocol streaming +…
Cloudbase
TencentCloudBase/CloudBase-AI-Toolkit
A skill your agent uses when you develop, design, build, deploy, debug, migrate, or troubleshoot CloudBase (腾讯云开发, 云开发, TCB, 微信云开发) projects — Web, 微信小程序, 小程序, uni-app, mobile (iOS, Android…
Related
Works with
Categories
Questions about Cloudbase Agent
What does Cloudbase Agent do?
Build and deploy AI agents with Cloudbase Agent (TypeScript), a TypeScript SDK implementing the AG-UI protocol. Cloudbase Agent is an agent skill from TencentCloudBase/CloudBase-AI-Toolkit. Build and deploy AI agents with Cloudbase Agent (TypeScript), a TypeScript SDK implementing the AG-UI protocol.
When should I use Cloudbase Agent?
Cloudbase Agent fits situations like: deploying agent servers with @cloudbase/agent-server; using LangGraph adapter with ClientStateAnnotation; using LangChain adapter with clientTools(); building custom adapters that implement AbstractAgent.
How do I install Cloudbase Agent in Claude Code?
Run `npx skills add TencentCloudBase/CloudBase-AI-Toolkit --skill cloudbase-agent -a claude-code`. Or copy the skill folder (config/source/skills/cloudbase-agent/ts in TencentCloudBase/CloudBase-AI-Toolkit) into .claude/skills/cloudbase-agent in your project. Claude Code loads it when a task matches its description.
How do I install Cloudbase Agent in Codex?
Run `npx skills add TencentCloudBase/CloudBase-AI-Toolkit --skill cloudbase-agent -a codex`. Or copy the skill folder (config/source/skills/cloudbase-agent/ts in TencentCloudBase/CloudBase-AI-Toolkit) into .agents/skills/cloudbase-agent in your project. Codex loads it when a task matches its description.
Can I use Cloudbase Agent in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add TencentCloudBase/CloudBase-AI-Toolkit --skill cloudbase-agent -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cloudbase-agent, .gemini/skills/cloudbase-agent, .github/skills/cloudbase-agent and .opencode/skills/cloudbase-agent in your project.
What does Cloudbase Agent need to run?
Going by SKILL.md and its folder, Cloudbase Agent needs the command-line tools its instructions call (npm). Our summary lists: Node.js.
Does Cloudbase Agent access the network?
SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Cloudbase Agent safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Cloudbase Agent use?
Cloudbase Agent is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Cloudbase Agent use?
About 947 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Cloudbase Agent?
Skills that share tags, products or a category with Cloudbase Agent: Add Example Agent (GetBindu/Bindu, 10k stars), Failproof AI SDK Integration (FailproofAI/failproofai, 5.3k stars), Agent Inspect (rajudandigam/agent-inspect, 165 stars) and Deep Agents Core (langchain-ai/langchain-skills, 1.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Cloudbase Agent?
TencentCloudBase (a GitHub organization) maintains it in TencentCloudBase/CloudBase-AI-Toolkit, which has 1,132 GitHub stars. The repository holds 49 skills in this directory. The repository was last updated on October 6, 2026.
Source: TencentCloudBase/CloudBase-AI-Toolkit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.