全面的代理技能，教AI助手如何在Web、iOS、Android和Flutter平台上构建快速、美观且安全的Mapbox应用。涵盖性能优化、制图设计、框架集成、平台迁移、搜索集成、地理空间操作、导航和安全最佳实践。

快速启动

Codex 插件本地测试

该仓库包含位于plugins/mapbox/.codex-plugin/plugin.json的Codex插件清单和位于.agents/plugins/marketplace.json的仓库市场。

Codex 市场目前期望有一个插件子目录，例如 plugins/mapbox。为了避免每个技能都被跟踪到第二个副本，请持续编辑根目录 skills/ 目录，并在测试前生成本地插件包：

然后重启Codex，并从Mapbox Agent Skills市场安装mapbox插件。

生成的plugins/mapbox/skills/和plugins/mapbox/.mcp.json文件被git忽略。

开放插件（光标、Codex、GitHub Copilot、Claude Code）

Mapbox Agent Skills

Comprehensive Agent Skills that teach AI assistants how to build fast, beautiful, secure Mapbox applications across Web, iOS, Android, and Flutter platforms. Covers performance optimization, cartographic design, framework integration, platform migration, search integration, geospatial operations, navigation, and security best practices.

Quick Start

Codex Plugin Local Testing

This repository includes a Codex plugin manifest at plugins/mapbox/.codex-plugin/plugin.json and a repo marketplace at .agents/plugins/marketplace.json.

Codex marketplaces currently expect a plugin subdirectory such as plugins/mapbox. To avoid maintaining a second tracked copy of every skill, keep editing the root skills/ directory and generate the local plugin package before testing:

npm run build:codex-plugin
codex plugin marketplace add .
codex plugin marketplace list

Then restart Codex and install the mapbox plugin from the Mapbox Agent Skills marketplace.

The generated plugins/mapbox/skills/ and plugins/mapbox/.mcp.json files are ignored by git.

Open Plugins (Cursor, Codex, GitHub Copilot, Claude Code)

This repository conforms to the Open Plugins specification, making it installable in any conformant tool - Cursor, Codex, GitHub Copilot, Claude Code, and more.

Add the marketplace source:

/plugin marketplace add mapbox/mapbox-agent-skills

Then install the plugin:

/plugin install mapbox

Claude Plugin (Claude Code)

Install as a Claude Code plugin to get skills and MCP servers in one step:

/plugin marketplace add mapbox/mapbox-agent-skills

Then install the plugin:

/plugin install mapbox

This adds all Mapbox skills and connects the mapbox, mapbox-devkit, and mapbox-docs MCP servers automatically.

Skills CLI

Install all Mapbox Agent Skills:

npx skills add mapbox/mapbox-agent-skills

Install specific skills:

npx skills add mapbox/mapbox-agent-skills --skill mapbox-web-performance-patterns

List available skills:

npx skills add mapbox/mapbox-agent-skills --list

💡 Pro tip: These skills work great on their own, but they’re even more powerful when combined with the Mapbox MCP DevKit Server. Skills provide the expertise (performance patterns, design principles), while MCP tools provide the actions (create styles, generate previews). Together, they enable complete workflows from design to deployment.

What are Agent Skills?

Agent Skills are folders containing instructions and resources that AI assistants (like Claude Code, Cursor, GitHub Copilot) can discover and use to perform tasks more effectively. Unlike tools (which provide actions) or prompts (which provide workflows), skills provide domain expertise - the “know-how” that helps AI make informed decisions.