Baidu Map JSAPI Skills

中文文档

This repository provides AI assistant Skills for Baidu Map JSAPI. Use them with Claude, Cursor, or other clients that support skills so the AI can reference accurate API docs and examples when you work with Baidu Map.

Included Skills

Skill	Description
bmap-jsapi-gl	Baidu Map JSAPI WebGL (BMapGL/BMap): map initialization, overlays (markers, polylines, polygons), events, layers, routing, geocoding, etc. For 2D and 2.5D map development.
bmap-jsapi-three	Baidu Map JSAPI Three (MapVThree): A Web-based 2D/3D integrated map visualization library built on three.js. Supports multi-source base map loading, 3D model loading, geo data visualization, natural environment rendering, measurement and editing, etc. For building professional 2D/3D integrated maps, WebGIS, digital twin and similar applications.
jsapi-ui-kit	Lightweight Baidu Map UI component library (@baidumap/jsapi-ui-kit). Provides PlaceSearch (keyword/nearby/bounds search) and PlaceDetail (POI details display) components for quick integration of standardized map UI.

How to Use

1. Clone the repo

git clone https://github.com/baidu-maps/jsapi-skills.git
cd jsapi-skills

2. Register the skill with your AI assistant

Link or copy the bmap-jsapi-gl, bmap-jsapi-three, and jsapi-ui-kit directories into your environment's skills folder so the AI can load its docs during conversations.

Claude Desktop (local)

• Skills directory is usually: ~/.claude/skills/
• Register via symlink (recommended):

  ln -sfn "$(pwd)/bmap-jsapi-gl" ~/.claude/skills/bmap-jsapi-gl
  ln -sfn "$(pwd)/bmap-jsapi-three" ~/.claude/skills/bmap-jsapi-three
  ln -sfn "$(pwd)/jsapi-ui-kit" ~/.claude/skills/jsapi-ui-kit

• Or copy the bmap-jsapi-gl, bmap-jsapi-three, and jsapi-ui-kit folders into ~/.claude/skills/.

Cursor

• Skills directory is usually: ~/.cursor/skills/
• Register via symlink (recommended):

  ln -sfn "$(pwd)/bmap-jsapi-gl" ~/.cursor/skills/bmap-jsapi-gl
  ln -sfn "$(pwd)/bmap-jsapi-three" ~/.cursor/skills/bmap-jsapi-three
  ln -sfn "$(pwd)/jsapi-ui-kit" ~/.cursor/skills/jsapi-ui-kit

• Or copy the bmap-jsapi-gl, bmap-jsapi-three, and jsapi-ui-kit folders into ~/.cursor/skills/.

3. Use it in chat

When your questions mention “Baidu Map”, “BMapGL”, “jsapi-gl”, “MapVThree”, “jsapi-ui-kit”, or similar, the assistant will use this skill’s docs to give answers and code that match the Baidu Map JSAPI.

Repo structure

.
├── bmap-jsapi-gl/          # Baidu Map JSAPI WebGL skill
│   ├── SKILL.md            # Skill entry and index
│   └── references/         # API reference docs
├── bmap-jsapi-three/       # MapV-Three 3D map skill
│   ├── SKILL.md            # Skill entry and index
│   └── references/         # API reference docs
├── jsapi-ui-kit/           # Baidu Map UI component library skill
│   ├── SKILL.md            # Skill entry and index
│   └── references/         # API reference docs
└── README.md

SKILL.md lists all reference files so the AI can load them as needed.

License

If a skill declares a license (e.g. MIT), that applies to that skill; the repo may use the same license.