Fireflies

Curated collection of AI agent skills for Hermes and other agent frameworks

Install

npx -y skills add magnus919/agent-skills --skill fireflies

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

25 days oldThe repository was created 25 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
21 stars21 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Query Fireflies.ai meeting transcripts, meeting notes, summaries, contacts, channels, AI meeting analytics, AskFred, audio uploads, and webhook signatures through its GraphQL API. Use when a user mentions Fireflies, Fireflies.ai, meeting transcripts or notes stored in Fireflies, AskFred, or Fireflies webhooks. Do not use for local audio transcription, calendar management, or meetings that are not Fireflies data.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

3.9 KB, as published. Nobody here has run it

Fireflies.ai

Use scripts/fireflies from this skill directory. It uses the Fireflies GraphQL endpoint directly and emits the API response as JSON. Read-only discovery is safe. Before any state change, confirm the target, scope, and rollback path; then route the change through the CLI's literal --confirm. --dry-run previews a payload only and never authorizes a write.

First Use

Check the command schema: scripts/fireflies --help and the relevant subcommand help.
Set FIREFLIES_API_KEY only for an actual API request. Do not expose or persist it.
Start with read-only discovery, such as scripts/fireflies transcripts list --limit 10 --json.
Use --dry-run --json before each mutation to inspect the exact GraphQL payload.

Command Map

Need	Command
Find transcript metadata	`scripts/fireflies transcripts list --keyword TEXT --limit 10 --json`
Read a meeting, summary, sentences, and analytics	`scripts/fireflies transcripts get ID --json`
People, channels, groups, contacts, apps	`users`, `channels`, `groups`, `contacts`, `apps`
Meeting analytics or live meetings	`analytics --start DATE --end DATE`, `meetings active`
Ask a transcript question	`askfred create --question TEXT --transcript-id ID --confirm`
Run an exact current/future API operation	`query --document GRAPHQL --variables JSON`
Verify a delivered webhook locally	`webhook verify --secret SECRET --signature sha256=... --body FILE`

Safe Mutation Workflow

Identify the Fireflies object ID and present the intended change.
Confirm target, scope, and rollback path with the user. Deletion may not be reversible.
Preview the exact document using --dry-run; this makes no HTTP request.
Run exactly the approved mutation with --confirm.
Return the response without printing credentials.

Examples:

scripts/fireflies meetings rename transcript-id --title "Weekly product review" --dry-run --json
scripts/fireflies meetings rename transcript-id --title "Weekly product review" --confirm --json
scripts/fireflies transcripts delete transcript-id --confirm --json

Reference Routing

Read references/cli-reference.md for syntax, output, exit codes, or generic GraphQL execution.
Read references/api-reference.md for the API model, exact documented operation families, limits, permissions, and source links.
Read references/workflows.md for transcript, analytics, upload, AskFred, and generic-operation recipes.
Read references/webhook-security.md when receiving or implementing Webhooks V2.
Read references/troubleshooting.md after an auth, GraphQL, limit, permission, pagination, or webhook failure.
Read references/source-index.md when validating source scope or documentation freshness.

Boundaries

The CLI never starts a webhook server, stores API keys, or guesses undocumented GraphQL fields. If an ergonomic command does not cover the needed current operation, use query or mutation with a documented GraphQL document. The generic mutation command still requires --confirm.