# mapbox-android-patterns

Скилл с официальными паттернами интеграции Mapbox Maps SDK v11 в Android: инициализация карты, маркеры, геопозиция, камера. Пригодится, когда агент пишет экран с картой.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1400 установок · ★ 83
- Автор: mapbox
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/mapbox/mapbox-agent-skills/tree/HEAD/skills/mapbox-android-patterns/SKILL.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/skills/mapbox-android-patterns

## Что делает

Скилл даёт агенту готовые шаблоны кода под Mapbox Maps SDK v11 на Android — на Kotlin, Jetpack Compose и классической View-системе. Внутри установка и настройка, добавление точечных аннотаций, показ местоположения пользователя, работа со стилями, камерой и обработка нажатий на объекты. Паттерны опираются на официальную документацию Mapbox.

Перед началом понадобится бесплатный аккаунт Mapbox и токен доступа: он кладётся в `app/res/values/mapbox_access_token.xml`. В `settings.gradle.kts` добавляется Maven-репозиторий Mapbox, в модульный `build.gradle.kts` — зависимость `com.mapbox.maps:android:11.18.1`, для Compose ещё `com.mapbox.extension:maps-compose:11.18.1`. Минимальный SDK — 21.

Отдельно в скилле отмечено разрешение `android.permission.INTERNET` в `AndroidManifest.xml`: без него карта не загрузится, а агенты часто пропускают его и сразу переходят к разрешениям на геолокацию. Это повод проверить манифест до первого запуска. Для Compose декларативного компонента для маркеров нет — аннотации добавляются императивно через `MapEffect`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add mapbox/mapbox-agent-skills --skill mapbox-android-patterns -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/mapbox-android-patterns/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/mapbox-android-patterns/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add mapbox/mapbox-agent-skills --skill mapbox-android-patterns -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/mapbox-android-patterns/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add mapbox/mapbox-agent-skills --skill mapbox-android-patterns -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/mapbox-android-patterns/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install mapbox/mapbox-agent-skills mapbox-android-patterns
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/mapbox-android-patterns/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add mapbox/mapbox-agent-skills --skill mapbox-android-patterns -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/mapbox/mapbox-agent-skills --path skills/mapbox-android-patterns
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/mapbox-android-patterns/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add mapbox/mapbox-agent-skills --skill mapbox-android-patterns -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/mapbox/mapbox-agent-skills/tree/HEAD/skills/mapbox-android-patterns/SKILL.md

## Когда брать
- подключить Mapbox Maps SDK к Android-проекту на Kotlin
- добавить точечные маркеры и аннотации на карту
- показать местоположение пользователя и вести за ним камеру
- загрузить свои данные в формате GeoJSON
- настроить стиль карты и обработать нажатия на объекты

## Примеры запросов агенту
- Добавь экран с картой Mapbox на Jetpack Compose и поставь камеру на Сан-Франциско
- Сделай несколько маркеров из списка координат через PointAnnotationManager
- Покажи местоположение пользователя и запроси разрешения на геолокацию

## Похожие
- [clerk-android](https://affpapa.org/nevibecode/skills/clerk-android.md) — скилл · 14400 установок
- [android-kotlin](https://affpapa.org/nevibecode/skills/android-kotlin.md) — скилл · 3300 установок
- [android-native-dev](https://affpapa.org/nevibecode/skills/android-native-dev.md) — скилл · 2700 установок
- [android-jetpack-compose](https://affpapa.org/nevibecode/skills/android-jetpack-compose.md) — скилл · 2200 установок
- [android-design-guidelines](https://affpapa.org/nevibecode/skills/android-design-guidelines.md) — скилл · 1700 установок
- [android-kotlin-development](https://affpapa.org/nevibecode/skills/android-kotlin-development.md) — скилл · 1500 установок

Из того же набора: [mapbox/mapbox-agent-skills](https://affpapa.org/nevibecode/by/mapbox/mapbox-agent-skills.md) — 18 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md