# api-onboarding

Помогает разработчику дойти до первого успешного ответа API быстрее: упрощает авторизацию, настраивает песочницу и интерактивные доки.

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

## Что делает

Скилл разбирает путь разработчика от знакомства с API до первого успешного ответа и подсказывает, где именно теряются люди. Он измеряет TTFAC — время до первого вызова — по шагам: поиск быстрого старта, регистрация, получение ключа, установка SDK, первый запрос. Для каждого шага предлагаются точки замера событий и расчёт медианы, а не среднего.

Отдельный блок про авторизацию. Скилл перечисляет антипаттерны вроде очереди на одобрение доступа, ключа, спрятанного в глубине настроек, и цепочки «подтверди почту, телефон, оплату — потом получишь ключ». Взамен советует сразу выдавать тестовый ключ, поддерживать простой заголовок с ключом на старте и откладывать продакшен-требования на потом.

Ещё внутри — требования к песочнице и приёмы интерактивной документации: отдельные эндпоинты, префиксы ключей, тестовые данные и магические значения карт, кнопка «попробовать» с реальным ответом API. Скилл опирается на соседний `developer-audience-context`, поэтому без него часть рекомендаций придётся собирать самому.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jonathimer/devmarketing-skills --skill api-onboarding -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jonathimer/devmarketing-skills --skill api-onboarding -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jonathimer/devmarketing-skills --skill api-onboarding -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install jonathimer/devmarketing-skills api-onboarding
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jonathimer/devmarketing-skills --skill api-onboarding -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/jonathimer/devmarketing-skills --path skills/api-onboarding
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add jonathimer/devmarketing-skills --skill api-onboarding -a opencode
```

### Claude.ai

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

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

## Когда брать
- посчитать время до первого успешного вызова API по шагам
- убрать лишние подтверждения на пути к тестовому ключу
- собрать песочницу с реалистичными ответами и ошибками
- добавить в доки кнопку «попробовать» с живым ответом
- найти шаг, на котором разработчики бросают интеграцию

## Примеры запросов агенту
- Разбери наш онбординг API и покажи, где теряется время до первого вызова
- Предложи, как упростить выдачу тестового ключа сразу после регистрации
- Составь чек-лист требований к песочнице для нашего API

## Похожие
- [codebase-onboarding](https://affpapa.org/nevibecode/skills/affaan-m-codebase-onboarding.md) — скилл · 5300 установок
- [create-onboarding-guide](https://affpapa.org/nevibecode/commands/create-onboarding-guide.md) — команда · 835 установок
- [wiki-onboarding](https://affpapa.org/nevibecode/skills/wiki-onboarding.md) — скилл · 5 установок
- [api-test-mode-design](https://affpapa.org/nevibecode/skills/api-test-mode-design.md) — скилл · 7800 установок
- [api-reference-documentation](https://affpapa.org/nevibecode/skills/api-reference-documentation.md) — скилл · 494 установки
- [api-documentation](https://affpapa.org/nevibecode/skills/bobmatnyc-api-documentation.md) — скилл · 379 установок

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

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

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