# use-spark

Даёт агенту доступ к почте, календарю, контактам и встречам в Spark через CLI. Пригодится, когда нужно найти письмо или свободное окно, не выходя из редактора.

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

## Что делает

Скилл учит агента работать с `spark` — тонким клиентом, который общается по IPC с запущенным Spark Desktop. Своей почты, сети и учётных данных у него нет: всё берётся из живого приложения на вашем компьютере. Поэтому запускать его в песочнице, контейнере или CI не получится — соединение не установится. Если Spark Desktop закрыт, попросите пользователя открыть его, повторные попытки ничего не дадут.

Команд около двадцати: `accounts`, `folders`, `emails`, `search`, `thread`, `attachment`, `draft`, `templates`, `events`, `availability`, `contacts`, `team`, `meetings`, `action` и другие. Начинать стоит с `spark accounts` — она покажет аккаунты, календари, команды и общие ящики вместе с уровнем доступа. Уровни три: read-only разрешает только чтение, triage добавляет черновики, комментарии и действия над письмами, send открывает отправку и работу с событиями календаря. Настраиваются они отдельно для каждого аккаунта и общего ящика в Settings -> AI Agents, и общий ящик может иметь другой уровень, чем родительский аккаунт. Команда сверх уровня вернёт ошибку с подсказкой, как его поднять.

Флаг `--json` переводит вывод в JSON: значения не обрезаются, ключи в snake_case, даты в ISO 8601. Ошибка при этом печатает `{"error": {"message": "…"}}` в stdout и завершается с ненулевым кодом. Для чтения глазами хватает текстового вывода, а для обработки берите JSON — например, `spark emails --json | jq '.emails[].id'`. Поля только добавляются, переименовывать или удалять их не будут.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add readdle/spark-cli-skills --skill use-spark -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add readdle/spark-cli-skills --skill use-spark -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add readdle/spark-cli-skills --skill use-spark -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install readdle/spark-cli-skills use-spark
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add readdle/spark-cli-skills --skill use-spark -a gemini-cli
```

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add readdle/spark-cli-skills --skill use-spark -a opencode
```

### Claude.ai

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

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

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

## Примеры запросов агенту
- покажи непрочитанные письма за последнюю неделю
- найди свободное окно на завтра с участниками встречи
- прочитай тред с последним письмом от клиента

## Похожие
- [daily-briefing](https://affpapa.org/nevibecode/skills/daily-briefing.md) — скилл · 3300 установок
- [google-cloud-solution-agentic-analytics-spark-knowledge-catalog](https://affpapa.org/nevibecode/skills/google-cloud-solution-agentic-analytics-spark-knowledge-catalog.md) — скилл · 5000 установок
- [spark-engineer](https://affpapa.org/nevibecode/skills/spark-engineer.md) — скилл · 3800 установок
- [extension-email-calendar-events](https://affpapa.org/nevibecode/skills/extension-email-calendar-events.md) — скилл · 28400 установок
- [gws-calendar](https://affpapa.org/nevibecode/skills/gws-calendar.md) — скилл · 61200 установок
- [persona-project-manager](https://affpapa.org/nevibecode/skills/persona-project-manager.md) — скилл · 31600 установок

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

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