Bmob Agent Skills

Production-oriented Agent Skills for Bmob backend cloud, designed for Cursor, Claude Code, OpenAI Codex, Gemini CLI, GitHub Copilot, and other agentskills.io-compatible AI tools.

@bmob/agent-skills helps AI agents generate platform-correct Bmob code and perform schema-aware operations through MCP. It reduces cross-platform API confusion, avoids unsafe key usage, and improves troubleshooting quality with deterministic routing.

Why this project

Correctness first: route prompts to the right platform skill (JavaScript, Android, iOS, Swift, REST) before code generation.
Operational capability: integrate the hosted Bmob MCP server for live table introspection and data operations.
Security guardrails: embed explicit “NOT for” constraints and key-usage boundaries inside skills.
Maintainability: references are synced from BmobDocs and validated in CI.
Portability: works across mainstream AI coding hosts with the same skill package.

What you get

Router skill: bmob (entrypoint for all Bmob-related prompts)
MCP operations: bmob-mcp (10 tools on server; 9 callable by agents, including deploy_cloud_function, invoke_cloud_function, deploy_static_site)
SDK/REST implementation skills:
- bmob-database-javascript
- bmob-database-android
- bmob-database-ios
- bmob-database-swift
- bmob-database-flutter
- bmob-database-restful
Troubleshooting skill: bmob-error-codes

Quick start

1) Install all skills (recommended)

npx skills add bmob/agent-skills -y -g

This copies all skills/* into your AI tool’s skills directory (for example: .cursor/skills/, .claude/skills/, ~/.codex/skills/, ~/.gemini/skills/).

2) Install specific skills

npx skills add bmob/agent-skills --skill bmob
npx skills add bmob/agent-skills --skill bmob-database-javascript
npx skills add bmob/agent-skills --skill bmob-mcp

3) Manual install

git clone https://github.com/bmob/agent-skills.git
# Cursor (project scope)
cp -r agent-skills/skills/bmob-database-javascript .cursor/skills/
# Claude Code (user scope)
cp -r agent-skills/skills/bmob ~/.claude/skills/
# OpenAI Codex
cp -r agent-skills/skills/bmob-mcp ~/.codex/skills/

Configure Bmob MCP (optional, recommended)

Use snippets from shared/mcp-install-snippets.md:

Cursor: .cursor/mcp.json or ~/.cursor/mcp.json
Claude Code: .mcp.json or ~/.claude.json
OpenAI Codex CLI: ~/.codex/config.toml
VS Code / GitHub Copilot: .vscode/mcp.json

Then ask:

List all tables in my Bmob project

The agent should call get_project_tables and return live schema.

Security note: current MCP endpoint is http://mcp.bmobapp.com/mcp (HTTP). Use in local development only, and never commit real keys.

Available skills

Skill	Purpose
`bmob`	Routing entrypoint for all Bmob prompts
`bmob-mcp`	Live MCP: 9 agent-callable tools (`get_project_tables`, `create_table`, `add_single_data`, `update_single_data`, `delete_single_data`, `generate_code`, `deploy_cloud_function`, `invoke_cloud_function`, `deploy_static_site`); do not call internal `mcp_endpoint_mcp_post`
`bmob-cloud-function-development`	Write Bmob server-side cloud functions and auto-upload / verify them via MCP when available
`bmob-database-javascript`	Cross-platform `hydrogen-js-sdk` for Web, Node.js, mini programs, Cocos Creator JS, Electron, Tauri, hybrid apps
`bmob-database-android`	Android native SDK (Java / Kotlin)
`bmob-database-ios`	Legacy iOS native SDK (Objective-C framework / Swift Bridging Header)
`bmob-database-swift`	Pure Swift `BmobSwiftSDK` with SPM / CocoaPods and async/await
`bmob-database-flutter`	Flutter / Dart SDK (`bmob_plugin` on pub.dev)
`bmob-database-restful`	REST API integration for backend languages and scripts
`bmob-error-codes`	Error-code lookup and diagnostics guidance

Usage examples

Prompt	Expected routing
“Add a GameScore row in Next.js with Bmob”	`bmob` + `bmob-database-javascript`
“How to query Bmob in Android Kotlin?”	`bmob` + `bmob-database-android`
“Swift async/await login with BmobSwiftSDK”	`bmob` + `bmob-database-swift`
“Swift Bridging Header login with BmobSDK”	`bmob` + `bmob-database-ios`
“Save a row with Bmob in Flutter”	`bmob` + `bmob-database-flutter`
“Give me curl for Bmob CRUD”	`bmob` + `bmob-database-restful`
“Create a Player table for me”	`bmob` + `bmob-mcp`
“Write and deploy a Bmob cloud function”	`bmob` + `bmob-cloud-function-development`
“What does error 9015 mean?”	`bmob` + `bmob-error-codes`

Project architecture

Skill users: install and use skills directly in AI tools
Maintainers: update skill logic and extract snippets from BmobDocs
CI: validates frontmatter and links, and runs MCP smoke checks when secrets are configured

See CONTRIBUTING.md for development workflow.

Local development (for maintainers)

Requirements: Node.js >=18, pnpm.

git clone --recurse-submodules https://github.com/bmob/agent-skills.git
cd agent-skills
pnpm install
pnpm run validate

Useful scripts:

pnpm run validate — frontmatter + relative link checks
pnpm run extract:local — extract snippets from local vendor/BmobDocs
pnpm run extract:remote — extract snippets from remote raw docs
pnpm run new:skill — scaffold a new skill

Roadmap

P0 (current): bmob, bmob-mcp, database x 6 platforms (incl. pure Swift and Flutter), error-codes; shared FAQ / anti-patterns / recipes
P1: auth x 4, storage x 4, cloud-function x 5, acl-and-roles, bql
P2: push x 4, sms x 2, pay-restful, data-hooks, scheduled-tasks; best-practices partly covered by shared/faq.md, shared/anti-patterns.md, shared/recipes/

FAQ

Do I need to manually enable a skill?

No. Skills are loaded on-demand by your AI host based on prompt content.

Can I use only one skill instead of all?

Yes. Install only what you need with --skill.

Is MCP required?

No. SDK/REST skills work without MCP. MCP is recommended when you need live schema/data operations inside the IDE.

Contributing

See CONTRIBUTING.md.

License

MIT — see LICENSE.

Agent Skills

README