Index of every page on this site: llms.txt
All skills
jeremylongshore avatar

/fireflies-install-auth

@820dfc8
Run it yourself

Establish a least-privilege Fireflies API identity, protect its bearer key, and prove the authenticated GraphQL boundary without exposing meeting data. Use when bootstrapping or repairing an integration. Trigger with "configure Fireflies API", "Fireflies auth failed", or "rotate Fireflies key".

Use this Skill: https://skilld.dev/gh/jeremylongshore/tons-of-skills-marketplace/fireflies-install-auth

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈80 tokens for metadata: the name and description. ≈933 when used: this file. ≈431 more on demand in 1 file.

Description uses 4.0% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈320 characters, or 4.0%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Fireflies API Identity and Access Setup

Overview

Create an auditable identity boundary before any transcript query or mutation. A successful request proves only that the key is accepted; it does not grant permission to enumerate or export meeting content.

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

Fireflies uses POST requests to https://api.fireflies.ai/graphql with Content-Type application/json and Authorization: Bearer <API key>. Obtain the key from the Fireflies Integrations page, keep it server-side, and use the smallest identity query needed to confirm the principal and team context.

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. Identify the owning Fireflies user or team, intended environment, and exact read or mutation capabilities.
  2. Create or retrieve the API key through the Fireflies dashboard; never ask a user to paste it into chat.
  3. Store the key in the approved secret manager and inject it as FIREFLIES_API_KEY only at runtime.
  4. Send a minimal user query from a controlled server-side client and inspect both HTTP status and the GraphQL errors array.
  5. Record the authenticated user ID, team context, key owner, storage location, and rotation owner without recording the key.
  6. Test an invalid-key path and confirm logs redact Authorization and response data.
  7. Document rotation and revocation steps before enabling production access.

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 creating, rotating, revoking, or broadening a production key, changing its owning account, or querying any real meeting record.

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

  • auth_failed: verify the Bearer scheme, secret injection, and key lifecycle without printing the token.
  • HTTP success with GraphQL errors: treat the operation as failed and record safe error metadata.
  • Unexpected team visibility: stop and review the key owner's role before continuing.

Examples

  • "Prove staging auth" returns only the principal and a redacted request receipt.
  • "Use this key in browser code" is rejected because bearer keys must remain server-side.

Resources

Read official Fireflies.ai evidence before relying on a field, filter, event, permission, plan limit, mutation, or processing state.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts2mo3 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    The skill provides a standard setup for Fireflies.ai API authentication, following security best practices such as using environment variables and .env protection via .gitignore. It uses official API endpoints and well-known libraries.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: LOW · No issues

Signed by skilld at 820dfc8. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 20 hours ago.

Activeupdated 2 months ago
What it can do
Reads files Edits files
Modelinherit
argument-hint
<repository-path> <environment>
version
1.12.0
author
Jeremy Longshore <jeremy@intentsolutions.io>
All 5 allowed tools
ReadGlobGrepWriteEdit
Other metadata
tags
[
  "saas",
  "fireflies",
  "authentication",
  "security"
]
model
inherit
effort
medium
compatibility
Designed for Claude Code; live Fireflies work requires network access

README badge

README badge for jeremylongshore/tons-of-skills-marketplace/fireflies-install-auth