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, 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 (8 tools on server; 7 callable by agents, including deploy_static_site)
• SDK/REST implementation skills:
  • bmob-database-javascript
  • bmob-database-android
  • bmob-database-ios
  • 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: 7 agent-callable tools (get_project_tables, create_table, add_single_data, update_single_data, delete_single_data, generate_code, deploy_static_site); do not call internal mcp_endpoint_mcp_post
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	iOS native SDK (Objective-C / Swift)
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 login with Bmob”	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
“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 5 platforms (incl. 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.