# conversation-history-brief

Скилл conversation-history-brief выгружает переписку контакта из всех ящиков HubSpot, сопоставляет каналы и собирает выжимку диалогов для клиентского отчёта.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 351 установка · ★ 30 у репозитория
- Автор: HubSpot
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/HubSpot/agent-cli-skills/tree/HEAD/conversation-history-brief/SKILL.md
- Обновлён: 2026-10-09
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/conversation-history-brief

## Что делает

Скилл собирает историю общения по `contact_id` через утилиту `hubspot`. В API HubSpot нельзя запросить треды контакта по всему порталу сразу: скрипт сначала обходит все ящики (`inboxes`), запрашивает ветки диалогов внутри каждого и затем выгружает текст сообщений.

Внутри заложена пагинация через курсор `.meta.next`: простой экспорт через флаг `--format jsonl` обрезает выдачу на первых ста строках. Скилл сопоставляет технический `originalChannelId` с типами каналов через справочник и подставляет заглушки, если у треда нет темы.

Скилл охватывает только сообщения из Conversations inbox. Звонки, заметки и обычные CRM-письма сюда не входят — для них нужен отдельный скилл `communication-history`.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add HubSpot/agent-cli-skills --skill conversation-history-brief -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add HubSpot/agent-cli-skills --skill conversation-history-brief -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add HubSpot/agent-cli-skills --skill conversation-history-brief -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install HubSpot/agent-cli-skills conversation-history-brief
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add HubSpot/agent-cli-skills --skill conversation-history-brief -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/HubSpot/agent-cli-skills --path conversation-history-brief
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add HubSpot/agent-cli-skills --skill conversation-history-brief -a opencode
```

### Claude.ai

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

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

## Когда брать
- собрать историю диалогов контакта по всем ящикам HubSpot
- обойти лимит в сто строк при чтении сообщений через API
- сопоставить идентификаторы каналов с их типами вроде почты и чата
- подготовить хронологию последних сообщений для клиентского брифа

## Примеры запросов агенту
- Собери историю переписки для контакта 73235
- Покажи недавние диалоги из всех ящиков для этого клиента
- Сделай выжимку сообщений контакта для брифа

## Похожие
- [twilio-conversation-orchestrator](https://affpapa.org/nevibecode/skills/twilio-conversation-orchestrator.md) — скилл · ★ 8052 у репозитория
- [Perspective AI](https://affpapa.org/nevibecode/mcp/perspective-ai.md) — MCP-сервер · ★ 6 у репозитория
- [monday-brief](https://affpapa.org/nevibecode/skills/monday-brief.md) — скилл · 1800 установок
- [hubspot](https://affpapa.org/nevibecode/skills/hubspot.md) — скилл · 858 установок
- [local-conversation-history](https://affpapa.org/nevibecode/skills/local-conversation-history.md) — скилл · 346 установок
- [call-list](https://affpapa.org/nevibecode/skills/call-list.md) — скилл · 1800 установок

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

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

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