base44-platform-agents — Claude Code skill for Base44
The base44-platform-agents Claude Code skill helps build AI agents inside Base44 apps. It applies when adding a conversational assistant or programmable AI.
MIT 3,000 installs ★ 94 updated 2026-10-22
npx skills add base44/skills --skill base44-platform-agents -a claude-codeWhat base44-platform-agents does
The skill explains how to configure Base44 agents and select the right guidance for an app. An agent is defined in a .jsonc file under base44/agents/; its conversation interface can use the agents SDK. Vite web apps use backend functions as agent tools, while TanStack Start apps use server routes.
To identify an app profile, the skill describes calling GET /api/apps/{app_id}/agent-profile through Base44 MCP’s execute_api tool or with a Base44 CLI token. The response gives the app type and the reference files to read. In-app agents work in web apps only; native Expo apps do not support them.
What it helps with
- define an AI agent in
base44/agents/ - connect backend functions to an agent in a Vite app
- choose agent guidance for a TanStack Start app
- build a conversation UI with the agents SDK
Example prompts for the agent
- Create a Base44 AI agent for my web app.
- Identify this app’s profile and configure an agent for TanStack Start.
- Build a conversation interface with the agents SDK.
How to install base44-platform-agents
1Skills CLI (Vercel)
npx skills add base44/skills --skill base44-platform-agents -a claude-code2Manually: put the files in place
~/.claude/skills/base44-platform-agents/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/base44-platform-agents/
1Skills CLI (Vercel)
npx skills add base44/skills --skill base44-platform-agents -a codex2Manually: put the files in place
.agents/skills/base44-platform-agents/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add base44/skills --skill base44-platform-agents -a cursor2Manually: put the files in place
.cursor/skills/base44-platform-agents/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install base44/skills skills/base44-platform-agents2Manually: put the files in place
.github/skills/base44-platform-agents/SKILL.md1Skills CLI (Vercel)
npx skills add base44/skills --skill base44-platform-agents -a gemini-cli2Platform CLI
gemini skills install https://github.com/base44/skills --path skills/base44-platform-agentsManually: put the files in place
.devin/skills/base44-platform-agents/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add base44/skills --skill base44-platform-agents -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 base44-platform-agents
How do I install base44-platform-agents in Claude Code?
Run npx skills add base44/skills --skill base44-platform-agents -a claude-code. The skill file is at ~/.claude/skills/base44-platform-agents/SKILL.md.
What does base44-platform-agents do?
It guides the setup of Base44 AI agents, including their JSONC configuration, app-specific tools, and conversation interfaces built with the agents SDK.
What does base44-platform-agents need to work?
To retrieve an app profile, use Base44 MCP with the execute_api tool or a Base44 CLI token. In-app agents are supported in web apps, not native Expo apps.
Source text
SKILL.md · MIT
---
name: base44-platform-agents
description: "Base44 in-app AI agents: JSON agent configs under base44/agents/ with entity, backend-function or server-route tools, WhatsApp and Telegram channels, the agents SDK for conversation UIs, and code agents (an agent loop the app runs on the AI gateway). Use when the app needs a conversational assistant or programmable AI."
---
<!-- GENERATED FILE. DO NOT EDIT. Compiled from the Base44 builder's prompt sources; the
source commit is in /SOURCE_COMMIT at the repository root. Edits here are overwritten by
the next sync; change the source instead. -->
# Base44 agents
An agent is a `.jsonc` file under `base44/agents/`; writing it defines the agent. Build the conversation UI with the agents SDK, or run a code agent on the AI gateway. In-app agents are available on web apps only; native mobile (Expo) apps do not support them.
## Pick the reference for this app
Determine the app profile first. Call `GET /api/apps/{app_id}/agent-profile` (over the Base44 MCP `execute_api`
tool, or with your Base44 CLI token); it returns the framework, app type, runtime,
entitlements and the exact reference files to read. Without it, detect from the project files:
`src/routes/__root.*` and `src/routeTree.gen.ts` mean TanStack Start; `app/_layout.*` means a
native mobile (Expo) app; otherwise it is a Vite SPA.
| Profile | Read |
|---|---|
| Web app, Vite SPA (the default web template) | [Agents (Vite SPA: tools are backend functions)](references/web-spa.md) |
| Web app, TanStack Start | [Agents (TanStack Start: tools are server routes)](references/web-tanstack.md) |
© base44 · MIT · base44/skills