# getting-started

Помогает выбрать абстракцию CrewAI и собрать каркас проекта через CLI, а не вручную. Пригодится на старте нового проекта.

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

## Что делает

Скилл разбирает пять уровней абстракции CrewAI: `LLM.call()` для одиночного промпта, `Agent.kickoff()` для одного агента с инструментами, `Crew.kickoff()` для нескольких агентов, `Flow` для приложения с состоянием и ветвлением и разговорный `Flow` для многошагового чата. Внутри есть таблица выбора и блок-схема решений, чтобы не гадать, что брать под задачу.

Главное правило скилла: файлы проекта не пишут руками. Сначала `crewai create flow <project_name>`, потом правка сгенерированных `agents.yaml`, `tasks.yaml`, `crew.py` и `main.py`. CLI расставляет импорты, структуру каталогов и `pyproject.toml`, а вручную это легко сделать с мелкими ошибками. Имя проекта скилл советует писать через подчёркивания: дефисы и пробелы CLI всё равно превратит в них.

Материал проверен на crewai 1.15.23, поэтому первым делом стоит выполнить `crewai version`. Если мажорная или минорная версия отличается от 1.15, детали придётся сверять заново — скилл отправляет за этим к `ask-docs`. Ещё одна ловушка: у `LLM.call()` аргумент называется `response_model`, а у `Agent.kickoff()` — `response_format`, и подмена даёт `TypeError`.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add crewAIInc/skills --skill getting-started -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add crewAIInc/skills --skill getting-started -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add crewAIInc/skills --skill getting-started -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install crewAIInc/skills getting-started
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add crewAIInc/skills --skill getting-started -a gemini-cli
```

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add crewAIInc/skills --skill getting-started -a opencode
```

### Claude.ai

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

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

## Когда брать
- выбрать между `LLM.call()`, `Agent.kickoff()`, `Crew.kickoff()` и `Flow` под конкретную задачу
- собрать каркас проекта CrewAI командой вместо ручного написания файлов
- описать агентов и задачи в `agents.yaml` и `tasks.yaml`
- связать `@CrewBase` в `crew.py` и шаги `@start`/`@listen` в `main.py`
- сделать многошаговый чат через `handle_turn()` и `chat()`

## Примеры запросов агенту
- Создай новый проект CrewAI под обработку заявок и покажи, какие файлы менять
- Мне нужен один агент с веб-поиском — что выбрать, `Agent.kickoff()` или `Crew.kickoff()`?
- Собери разговорный Flow с `handle_turn()` для чата поддержки

## Похожие
- [neo4j-getting-started-skill](https://affpapa.org/nevibecode/skills/neo4j-getting-started-skill.md) — скилл · 888 установок
- [webflow-university:mcp-getting-started](https://affpapa.org/nevibecode/skills/webflow-universitymcp-getting-started.md) — скилл · 432 установки
- [resilience-hub-getting-started](https://affpapa.org/nevibecode/skills/resilience-hub-getting-started.md) — скилл · 3900 установок
- [multi-agent-orchestration](https://affpapa.org/nevibecode/skills/multi-agent-orchestration.md) — скилл · 2100 установок
- [crewai](https://affpapa.org/nevibecode/skills/crewai.md) — скилл · 141 установка
- [skill-creator](https://affpapa.org/nevibecode/skills/starchild-ai-agent-skill-creator.md) — скилл · 7800 установок

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

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

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