---
title: "Agent Skills"
description: "The docs site publishes the movk-mapbox Agent Skill so AI tools can learn to build maps declaratively with this library in a single command."
canonical_url: "https://mapbox.mhaibaraai.cn/en/docs/getting-started/ai/skills"
---
# Agent Skills

> The docs site publishes the movk-mapbox Agent Skill so AI tools can learn to build maps declaratively with this library in a single command.

## What are Skills?

Skills are structured files that give AI coding agents library- and framework-specific knowledge. Unlike the [MCP Server](https://mapbox.mhaibaraai.cn/docs/getting-started/ai/mcp), which provides real-time tool access, a Skill is loaded directly into the agent's context so it can be referenced throughout an entire conversation.

The docs site publishes a **usage skill** called `movk-mapbox` that teaches AI agents to build maps with `@movk/mapbox`. It follows the [Agent Skills](https://docs.claude.com/en/docs/agents-and-tools/agent-skills) specification and is automatically published to the `/.well-known/skills/` endpoint.

## What's Covered

The `movk-mapbox` skill covers:

- Installation and token configuration (Nuxt module / Vue + Vite plugin)
- The declarative core pattern: `MapboxMap` + `MapboxSource` + `MapboxLayer`
- SSR safety, no `<ClientOnly>` needed, and camera `v-model` loop-breaking
- Tianditu basemaps, CRS conversion (WGS84/GCJ02/BD09), drawing, and buffer/measurement
- A set of mandatory conventions (container height, `omitUndefined`, layer lifecycle, etc.)

The skill ships with on-demand `references/` (components / recipes / conventions) so agents only fetch details when needed, keeping context lean.

> [!NOTE]
> 
> Browse the skills published on this site: 
> 
> /.well-known/skills/index.json
> 
> . Once installed, type 
> 
> /movk-mapbox
> 
>  in your agent chat to invoke it.

### Skills CLI

The [`skills`](https://skills.sh) CLI is the easiest way to install a Skill — it auto-detects installed agents (Claude Code, Cursor, Windsurf, etc.) and installs to all of them at once:

```bash [Terminal]
npx skills add https://mapbox.mhaibaraai.cn
```

> [!TIP]
> 
> Visit 
> 
> skills.sh
> 
>  to explore the Skills ecosystem and discover more available skills.

### Claude Code

> [!NOTE]
> 
> Make sure Claude Code is installed — see the 
> 
> Anthropic documentation
> 
>  for setup instructions.

Add the skill via CLI:

```bash [Terminal]
claude skill add https://mapbox.mhaibaraai.cn
```

### Cursor

1. Open Cursor and go to **Settings** > **Skills**
2. Click **Add skill** and enter the site URL:

```text
https://mapbox.mhaibaraai.cn
```

### Other AI Tools

The skill files are publicly available at `/.well-known/skills/` and can be referenced directly in any tool that supports custom context:

- Skill index: [`/.well-known/skills/index.json`](https://mapbox.mhaibaraai.cn/.well-known/skills/index.json)
- Skill entry: [`/.well-known/skills/movk-mapbox/SKILL.md`](https://mapbox.mhaibaraai.cn/.well-known/skills/movk-mapbox/SKILL.md)


## Sitemap

See the full [sitemap](https://mapbox.mhaibaraai.cn/sitemap.md) for all pages.