cloudbase-agent — Claude Code skill: what it does, how to install
Helps build and deploy CloudBase Agent SDK servers in TypeScript or Python with streaming via the AG-UI protocol.
MIT 268 installs ★ 82 updated 2026-11-15
npx skills add TencentCloudBase/skills --skill cloudbase-agent -a claude-codeWhat cloudbase-agent does
This skill routes agent generation tasks to the right CloudBase Agent SDK guides for TypeScript (@cloudbase/agent-server) or Python (cloudbase-agent-server with FastAPI). Before generating code, it detects the stack and reads ts/skill.md or py/skill.md. If no programming language is mentioned, it defaults strictly to TypeScript.
The system relies on the AG-UI protocol for real-time event streaming between backend agents and web or mini-program clients. It includes guidance for LangGraph, LangChain, and CrewAI adapters, alongside custom implementations. Keep sibling skills available locally: fetching remote skill files over HTTP into context is prohibited.
What it helps with
- deploy an agent server using
@cloudbase/agent-serverin TypeScript - set up a Python agent backend using FastAPI and
cloudbase-agent-server - stream AG-UI protocol events to web or mini-program frontends
- integrate LangGraph, LangChain, or CrewAI adapters
Example prompts for the agent
- Build a FastAPI agent server that streams events with the AG-UI protocol
- Set up a TypeScript agent using
@cloudbase/agent-serverwith LangGraph - Create a custom adapter for our web client with CloudBase Agent SDK
How to install cloudbase-agent
1Skills CLI (Vercel)
npx skills add TencentCloudBase/skills --skill cloudbase-agent -a claude-code2Manually: put the files in place
~/.claude/skills/cloudbase-agent/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/cloudbase-agent/
1Skills CLI (Vercel)
npx skills add TencentCloudBase/skills --skill cloudbase-agent -a codex2Manually: put the files in place
.agents/skills/cloudbase-agent/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add TencentCloudBase/skills --skill cloudbase-agent -a cursor2Manually: put the files in place
.cursor/skills/cloudbase-agent/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install TencentCloudBase/skills skills/cloudbase-agent2Manually: put the files in place
.github/skills/cloudbase-agent/SKILL.md1Skills CLI (Vercel)
npx skills add TencentCloudBase/skills --skill cloudbase-agent -a gemini-cli2Platform CLI
gemini skills install https://github.com/TencentCloudBase/skills --path skills/cloudbase-agentManually: put the files in place
.devin/skills/cloudbase-agent/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add TencentCloudBase/skills --skill cloudbase-agent -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about cloudbase-agent
How do I install cloudbase-agent in Claude Code?
Run npx skills add TencentCloudBase/skills --skill cloudbase-agent -a claude-code in your terminal.
What does cloudbase-agent do?
It routes your AI assistant to the correct CloudBase Agent SDK documentation for TypeScript or Python to configure AG-UI streaming.
What happens if I do not specify a language?
The skill automatically routes the workflow to TypeScript and requires the model to read ts/skill.md before generating code.
Source text
SKILL.md · MIT
--- name: cloudbase-agent description: Build and deploy AI agents with CloudBase Agent SDK (TypeScript & Python). Implements the AG-UI protocol for streaming agent-UI communication. Use when deploying agent servers, using LangGraph/LangChain/CrewAI adapters, building custom adapters, understanding AG-UI protocol events, or building web/mini-program UI clients. Supports both TypeScript (@cloudbase/agent-server) and Python (cloudbase-agent-server via FastAPI). version: 2.37.6 license: MIT alwaysApply: false --- ## Sibling skills (local only) Sibling CloudBase skills ship beside this skill. Use local relative paths such as `../auth-tool-cloudbase/SKILL.md`. If a referenced sibling skill file is missing from this environment, ask the user to install the full CloudBase plugin (or the missing skill). Do **not** HTTP-fetch remote skill or protocol markdown into the agent context. # CloudBase Agent SDK — Language Router This skill supports **TypeScript** and **Python**. Determine the language first, then read the corresponding skill file. If the user does not explicitly specify which programming language to use, TypeScript must be enforced. ## Step 1: Determine Language | Signal | Language | |--------|----------| | User says "TypeScript", "Node.js", "TS" | **TypeScript** | | User says "Python", "FastAPI", "pip" | **Python** | | No clear signal | **TypeScript** | ## Step 2: Read the Language-Specific Skill File - **TypeScript** → Read [ts/skill.md](ts/skill.md) — then follow ALL instructions in that file - **Python** → Read [py/skill.md](py/skill.md) — then follow ALL instructions in that file **⚠️ IMPORTANT:** After determining the language, you MUST read the corresponding skill file above. Do NOT proceed with any code generation until you have read it. Each language skill file is self-contained with its own quick start, routing table, deployment instructions, and adapter guides.
© TencentCloudBase · MIT · TencentCloudBase/skills