---
title: "Agent Skills"
description: "文档站发布 movk-mapbox Agent Skill，让 AI 工具一条命令即可学会用本库声明式地构建地图。"
seo_title: "Agent Skills"
seo_description: "Install the movk-mapbox Agent Skill into Claude Code, Cursor or Windsurf to teach AI assistants how to build maps with the declarative @movk/mapbox components."
canonical_url: "https://mapbox.mhaibaraai.cn/docs/getting-started/ai/skills"
---
# Agent Skills

> 文档站发布 movk-mapbox Agent Skill，让 AI 工具一条命令即可学会用本库声明式地构建地图。

## 什么是 Skills？

Skills 是为 AI 编码代理提供库/框架专属知识的结构化文件。与 [MCP Server](/docs/getting-started/ai/mcp) 提供实时工具访问不同，Skill 直接加载进代理上下文，使其在整段对话中都能参考。

文档站提供一个 **usage skill** `movk-mapbox`，教 AI 代理用 `@movk/mapbox` 构建地图：遵循 [Agent Skills](https://docs.claude.com/en/docs/agents-and-tools/agent-skills){rel="[\"nofollow\"]"} 规范，自动发布到 `/.well-known/skills/` 端点。

## 用法

`movk-mapbox` skill 涵盖：

- 安装与 token 配置（Nuxt 模块 / Vue + Vite 插件）
- `MapboxMap` \+ `MapboxSource` \+ `MapboxLayer` 声明式核心范式
- SSR 安全、无需 `<ClientOnly>`，相机 `v-model` 断回环
- 天地图底图、坐标系转换（WGS84/GCJ02/BD09）、绘制与缓冲量算
- 一组必须遵守的约定（容器高度、`omitUndefined`、图层生命周期等）

Skill 附带按需加载的 `references/`（components / recipes / conventions），让代理只在需要时拉取细节，保持上下文精简。

> \[\!NOTE\]
> 
> 查看本站已发布的 Skills：
> 
> /.well-known/skills/index.json
> 
> 。安装后可在代理聊天中输入 
> 
> /movk-mapbox
> 
>  调用。

### Skills CLI

[`skills`](https://skills.sh){rel="[\"nofollow\"]"} CLI 是安装 Skill 最简单的方式，会自动检测已安装的 Claude Code、Cursor、Windsurf 等代理并一并安装：

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

> \[\!TIP\]
> 
> 访问 
> 
> skills.sh
> 
>  了解 Skills 生态与更多可用技能。

### Claude Code

> \[\!NOTE\]
> 
> 确保已安装 Claude Code，安装说明见 
> 
> Anthropic 文档
> 
> 。

用 CLI 添加技能：

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

### Cursor

1. 打开 Cursor，进入「Settings」>「Skills」
2. 点击「Add skill」并填入站点地址：

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

### 其他 AI 工具

Skill 文件公开发布于 `/.well-known/skills/`，任何支持自定义上下文的工具都可直接引用：

- 技能索引：[`/.well-known/skills/index.json`](https://mapbox.mhaibaraai.cn/.well-known/skills/index.json){rel="[\"nofollow\"]"}
- 技能入口：[`/.well-known/skills/movk-mapbox/SKILL.md`](https://mapbox.mhaibaraai.cn/.well-known/skills/movk-mapbox/SKILL.md){rel="[\"nofollow\"]"}


## Sitemap

See the full [sitemap](/sitemap.md) for all pages.