Przejdź do treści
Biblioteka skilli
Programowanie · Analiza

fireflies-common-errors

/fireflies-common-errors

Diagnozuje awarie transportu, GraphQL, uprawnień, planu, przetwarzania i limitów operacji w Fireflies bez niebezpiecznych ponowień i sondowania danych.

Licencja
MIT
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Diagnozuje awarie transportu, GraphQL, uprawnień, planu, przetwarzania i limitów operacji w Fireflies bez niebezpiecznych ponowień i sondowania danych.

Wyzwalacze z opisu

Fireflies errortoo_many_requestsobject_not_found Fireflies

Argumenty

/fireflies-common-errors <repository-path> <workflow-scope>
Oryginalny opis (EN)

Diagnose Fireflies transport, GraphQL, permission, plan, processing, and operation-limit failures without unsafe retries or data probing. Use when an integration fails or returns partial data. Trigger with "Fireflies error", "too_many_requests", or "object_not_found Fireflies".

Jak działa

  1. Overview
  2. Prerequisites
  3. Current Contract
  4. Authentication
  5. Instructions
  6. Tool Discipline
  7. Approval Boundaries
  8. Output
  9. Validation
  10. Error Handling
Sekcje z nagłówków SKILL.md, w oryginale · 61 linii, 464 słów
Podgląd SKILL.md
---
name: fireflies-common-errors
description: >-
  Diagnose Fireflies transport, GraphQL, permission, plan, processing, and operation-limit failures without unsafe retries or data probing. Use when an integration fails or returns partial data. Trigger with "Fireflies error", "too_many_requests", or "object_not_found Fireflies".
allowed-tools: Read,Glob,Grep,Write,Edit
argument-hint: "<repository-path> <workflow-scope>"
version: 1.12.0
license: MIT
author: Jeremy Longshore <jeremy@intentsolutions.io>
tags: [saas, fireflies, errors, troubleshooting]
model: inherit
effort: high
compatibility: "Designed for Claude Code; live Fireflies work requires network access"
---
# Fireflies Error Taxonomy and Recovery

## Overview

Diagnose Fireflies transport, GraphQL, permission, plan, processing, and operation-limit failures without unsafe retries or data probing.

## 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

Separate HTTP failures from top-level GraphQL errors and domain state. Normalize auth_failed, object_not_found, invalid_args or invalid_arguments, require_elevated_privilege, require_ai_credits, too_many_requests, unsupported_platform, and processing-state nulls.

## 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. Capture operation name, HTTP status, safe GraphQL error code, retryAfter, request ID, and timing.
2. Classify the failure before changing queries, permissions, or retry behavior.
3. For object_not_found, validate authorization and ID without enumeration.
4. For privilege or credit errors, stop and route to the accountable owner.
5. For throttling, honor retryAfter and the operation-specific limit.
6. Reproduce with synthetic variables or metadata-only selections.
7. Return a redacted diagnosis and the smallest safe next action.

## 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 changing roles, plans, keys, privacy, meeting access, or replaying a mutation. Preserve the failing state and present the exact proposed change before acting.

## 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

- Unknown error text: preserve the code and safe metadata, then consult current error docs.
- HTTP 200 with errors: fail the operation rather than ignoring the errors array.
- Repeated retry failure: open an incident instead of widening backoff indefinitely.

## Examples

- "Review fireflies error taxonomy and recovery" 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.
Pliki w paczce (2)
  • SKILL.md 4 KB
  • references/official-docs.md 2 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · jeremylongshore/tons-of-skills-marketplace100MIT
HelixDevelopment/agent100MIT

Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

Migawka bazy z 13.11.2026 · wersja paczki 22694a0678e9 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 1 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100fireflies-rate-limits
    Wdraża limity zapytań, backoff i idempotencję w Fireflies.ai oraz obsługę błędów limitów i logikę ponowień.
  • 100fireflies-sdk-patterns
    Buduje typowanego klienta GraphQL Fireflies z nazwami operacji, zmiennymi, obsługą błędów, redakcją danych i wstrzykiwaniem zależności, zamiast ad hoc żądań.
  • 100mistral-common-errors
    Diagnozuje błędy Mistral dotyczące uwierzytelniania, walidacji, limitów, modeli, transportu i dostawcy, bez niebezpiecznych ponowień.
  • 100fireflies-install-auth
    Instaluje i konfiguruje uwierzytelnianie SDK i CLI Fireflies.ai, w tym klucze API i inicjalizację w projekcie.
  • 100fireflies-transcript
    Pobiera surowe transkrypty spotkań z Fireflies.ai, wyłącznie na wyraźne wywołanie komendy /fireflies-transcript.
  • 100fireflies
    Odpytuje przez API GraphQL transkrypty spotkań, notatki, streszczenia, kontakty, kanały, analitykę, AskFred, wgrywanie audio i podpisy webhooków z Fireflies.ai.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.