Bmob Agent Skills

English | 简体中文

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 (12 tools on server; 11 callable by agents, including deploy_cloud_function, invoke_cloud_function, list_cloud_functions, get_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 for a specific AI tool (recommended)

Choose the command for your tool. -g installs at user scope, -y skips confirmation, and --agent explicitly selects the target so the CLI does not automatically include tools that only support project-level installation.

# Cursor
npx skills add bmob/agent-skills -y -g --agent cursor
# Claude Code
npx skills add bmob/agent-skills -y -g --agent claude-code
# OpenAI Codex
npx skills add bmob/agent-skills -y -g --agent codex
# Gemini CLI
npx skills add bmob/agent-skills -y -g --agent gemini-cli
# GitHub Copilot
npx skills add bmob/agent-skills -y -g --agent github-copilot

Repeat --agent to install for multiple tools:

npx skills add bmob/agent-skills -y -g --agent cursor --agent claude-code

These commands install all skills/*. Depending on the targets, the CLI uses shared storage, symlinks, or copies; check its output for the actual installation paths. See the skills CLI supported agents for more tool identifiers.

2) Install specific skills

npx skills add bmob/agent-skills -y -g --agent cursor --skill bmob
npx skills add bmob/agent-skills -y -g --agent cursor --skill bmob-database-javascript
npx skills add bmob/agent-skills -y -g --agent cursor --skill bmob-mcp

Replace cursor with your tool identifier. For project-level installation, omit -g and run the command from the target project directory.

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/

4) Troubleshooting: PromptScript does not support global skill installation

This is an installation target/scope mismatch: PromptScript only supports project-level installation. Without --agent, the CLI's automatic selection can include it as a universal target even when you have not installed PromptScript. Failed to install 10 means the ten skills each failed for the PromptScript target; check the preceding Installed list for other tools. The final Done! does not mean every target succeeded.

For Cursor, Claude Code, or another tool, retry with an explicit --agent as shown above. Avoid --all -g, which also selects targets without global installation support. If you use PromptScript, run this from your target project directory:

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

This installs into the project's .agents/skills/. See the upstream scope support table.

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: 11 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, list_cloud_functions, get_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, runs MCP transport regression tests and TypeScript checks, and runs live 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 links, MCP transport regression tests, and TypeScript 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.