fireflies-webhooks-events — скилл для Claude Code
Скилл fireflies-webhooks-events проводит агента по сборке приёмника Fireflies Webhooks V2: проверка HMAC по сырому телу, белый список событий, дедупликация и быстрый ответ 2xx.
MIT 1 установок ★ 2 935 обновлён 2026-10-29
npx skills add jeremylongshore/tons-of-skills-marketplace --skill fireflies-webhooks-events -a claude-codeЧто делает fireflies-webhooks-events
Скилл разбирает приёмную сторону Fireflies Webhooks V2: что проверять до парсинга JSON, как отсекать неизвестные события и не выполнять работу дважды при повторной доставке. Внутри — порядок из семи шагов, начиная с подписки на одобренные типы событий на HTTPS-эндпоинте и проверки X-Hub-Signature в формате sha256=<hex HMAC> по сырым байтам.
Подпись считается по сырому телу, поэтому читать поток как JSON раньше времени нельзя. Документированы события meeting.transcribed и meeting.summarized; в payload есть event, timestamp, meeting_id и необязательный client_reference_id. Fireflies ждёт 2xx в течение 10 секунд, поэтому скилл советует сначала подтвердить приём, а данные забрать асинхронно.
Ключи идут отдельным блоком: FIREFLIES_API_KEY берётся из хранилища секретов и уходит только в заголовке Authorization: Bearer на https://api.fireflies.ai/graphql. Секрет подписи вебхука хранится отдельно и не заменяет API-ключ. Живая работа требует сетевого доступа. Операции вроде подписки на события всей команды или выгрузки транскрипта после события скилл останавливает до подтверждения.
Какие задачи решает
- Проверить подпись
X-Hub-Signatureпо сырому телу до парсинга JSON - Отсеять неизвестные события в карантин, не достраивая схему
- Сделать обработчик идемпотентным при повторной доставке
- Пережить приход
meeting.summarizedраньшеmeeting.transcribed - Уложить ответ 2xx в 10 секунд и вынести обработку в фон
Примеры запросов агенту
- Разбери приёмник вебхуков Fireflies V2 в
apps/webhooks, начни с проверки подписи и дедупликации. - Проверь, как у нас валидируется
X-Hub-Signature, и покажи, где JSON парсится раньше проверки. - Добавь обработку
meeting.summarizedс идемпотентностью поmeeting_id, scope — только этот обработчик.
Как установить fireflies-webhooks-events
1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill fireflies-webhooks-events -a claude-code2Вручную: положить файлы
~/.claude/skills/fireflies-webhooks-events/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/fireflies-webhooks-events/
1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill fireflies-webhooks-events -a codex2Вручную: положить файлы
.agents/skills/fireflies-webhooks-events/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill fireflies-webhooks-events -a cursor2Вручную: положить файлы
.cursor/skills/fireflies-webhooks-events/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jeremylongshore/tons-of-skills-marketplace skills/.curated/fireflies-webhooks-events2Вручную: положить файлы
.github/skills/fireflies-webhooks-events/SKILL.md1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill fireflies-webhooks-events -a gemini-cli2Командой платформы
gemini skills install https://github.com/jeremylongshore/tons-of-skills-marketplace --path skills/.curated/fireflies-webhooks-eventsВручную: положить файлы
.devin/skills/fireflies-webhooks-events/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill fireflies-webhooks-events -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о fireflies-webhooks-events
Как установить fireflies-webhooks-events в Claude Code?
Выполните npx skills add jeremylongshore/tons-of-skills-marketplace --skill fireflies-webhooks-events -a claude-code. Скилл появится по пути ~/.claude/skills/fireflies-webhooks-events/SKILL.md.
Что делает fireflies-webhooks-events?
Проводит агента по сборке приёмника Fireflies Webhooks V2: проверка HMAC по сырым байтам, белый список событий, дедупликация, терпимость к порядку доставки и быстрый ответ 2xx.
Нужен ли ключ Fireflies для работы скилла?
Для живых запросов нужен FIREFLIES_API_KEY из хранилища секретов: он уходит только в заголовке Authorization: Bearer на https://api.fireflies.ai/graphql. Секрет подписи вебхука — отдельный креденшел, и сетевой доступ обязателен.
Исходный текст
SKILL.md · MIT
--- name: fireflies-webhooks-events description: >- Implement a current Fireflies Webhooks V2 consumer with raw-body HMAC verification, event allowlisting, idempotency, ordering tolerance, and fast acknowledgement. Use when performing meeting lifecycle automation. Trigger with "Fireflies webhook v2", "meeting.transcribed event", or "verify Fireflies signature". allowed-tools: Read,Glob,Grep,Write,Edit argument-hint: "<repository-path> <workflow-scope>" version: 1.12.0 license: MIT author: Jeremy Longshore <[email protected]> tags: [saas, fireflies, webhooks, events] model: inherit effort: high compatibility: "Designed for Claude Code; live Fireflies work requires network access" --- # Fireflies Webhooks V2 Consumer ## Overview Implement a current Fireflies Webhooks V2 consumer with raw-body HMAC verification, event allowlisting, idempotency, ordering tolerance, and fast acknowledgement. ## Prerequisites - The target repository or integration path and the requested operator outcome. - The Fireflies principal, team, environment, and data classification for the work. - Current Fireflies documentation, credentials only when needed, and an accountable approver. ## Current Contract V2 payloads contain event, timestamp, meeting_id, and optional client_reference_id. Documented events include meeting.transcribed and meeting.summarized. X-Hub-Signature is sha256=<hex HMAC> over the raw body; valid deliveries need a 2xx response within 10 seconds. ## Authentication For authenticated operations, inject `FIREFLIES_API_KEY` from an approved secret manager and send it only as `Authorization: Bearer REDACTED_KEY` to `https://api.fireflies.ai/graphql`. Never print, commit, place in a URL, forward to a browser, or include the key in evidence. Webhook signing secrets are separate credentials and must not be reused as API keys. ## Instructions 1. Subscribe only to approved V2 event types at an HTTPS endpoint. 2. Capture raw bytes and validate the signature format and timing-safe HMAC before JSON parsing. 3. Validate event, timestamp, meeting_id, and optional client reference against a strict schema. 4. Reject unknown events or route them to a quarantined metadata-only lane. 5. Deduplicate using delivery metadata plus event and meeting identity, and tolerate summarized arriving after transcribed. 6. Acknowledge quickly, then fetch authorized data asynchronously if needed. 7. Record signature result, event type, latency, dedupe outcome, and job ID without payload content. ## Tool Discipline Use Read, Glob, and Grep to inspect code, configuration, tests, and evidence. Use Write/Edit only for approved implementation or documentation changes. Do not query Fireflies, retrieve meeting content, create an AskFred thread, upload media, change account state, replay an event, or deploy merely because this skill was invoked. ## Approval Boundaries Require approval before subscribing to team-wide events, fetching transcript content after an event, replaying a delivery, or retaining payloads. ## Output Return the exact operation or event surface, environment, authorization class, selected field groups, validation results, content-free metrics, decisions, and a concise pass/fail receipt. Keep secrets and meeting-derived content out of general output. ## Validation Before reporting success, rerun the smallest relevant deterministic check, compare actual state with the requested outcome and current contract, verify no secret or meeting-derived content entered logs or artifacts, and record unresolved uncertainty explicitly. ## Error Handling - Missing signature when verification is configured: return 401. - Duplicate delivery: acknowledge without repeating side effects. - Unknown event: quarantine metadata and do not infer a schema. ## Examples - "Review fireflies webhooks v2 consumer" produces a bounded plan and redacted receipt. - A request that widens access or mutates production is paused at the approval boundary. ## Resources Read [official Fireflies.ai evidence](references/official-docs.md) before relying on a field, filter, event, permission, plan limit, mutation, or processing state.
© Jeremy Longshore · MIT · jeremylongshore/tons-of-skills-marketplace