Agent skill

Fireflies Transcript

by davidondrej in davidondrej/skills

Fetch raw Fireflies.ai meeting transcripts. An agent skill from davidondrej/skills.

MITAuto-check passedKnowledge Management

Install Fireflies Transcript

skills CLI
$ npx skills add davidondrej/skills --skill fireflies-transcript -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install davidondrej/skills fireflies-transcript --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/davidondrej/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/research-and-web/fireflies-transcript .claude/skills/fireflies-transcript && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
fireflies-transcript
GitHub stars
4.1k
Token cost
~704 tokens
SKILL.md length
241 words
Files
2
Skills in repo
51
Repo updated
First seen
Licence
MIT

At a glance

Fetch raw Fireflies.ai meeting transcripts. An agent skill from davidondrej/skills.

  • Works in 2 steps: find the meeting id → pull the raw transcript
  • Explicitly invokes /fireflies-transcript
  • SKILL.md covers Auth (state-check first), Step 1 - find the meeting id, Step 2 - pull the raw transcript and Failure modes, plus 1 more section
  • Calls jq and curl; reaches api.fireflies.ai; needs API_KEY

What it does

Fireflies Transcript is an agent skill from davidondrej/skills. Fetch raw Fireflies.ai meeting transcripts. Use only when the user explicitly invokes /fireflies-transcript; for YouTube, use youtube-transcript.

Its SKILL.md is about 700 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Knowledge Management, covering Video and podcast notes. It works with YouTube. The repository describes itself as: access to david ondrej's personal agent skills. The licence is MIT.

When your agent uses it

  • Explicitly invokes /fireflies-transcript
  • Use youtube-transcript

Example prompts

  • “/fireflies-transcript”

Requirements

  • A credential in API_KEY

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. find the meeting id
  2. pull the raw transcript

What it can do on your machine

Read from SKILL.md and the folder at commit ea32e5f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • jq
    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.fireflies.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Fireflies Transcript loads about 704 tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 241 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~42
When it runs · the whole SKILL.md, loaded when a task matches
~704

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from davidondrej/skills at commit ea32e5f, republished under its MIT licence (© davidondrej). 241 words, ~704 tokens.

Download SKILL.mdSave it as .claude/skills/fireflies-transcript/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
fireflies-transcript
description
Fetch raw Fireflies.ai meeting transcripts. Use only when the user explicitly invokes /fireflies-transcript; for YouTube, use youtube-transcript.
disable-model-invocation
true

Fireflies Transcript

Fetch any meeting transcript from Fireflies.ai as raw text via GraphQL. Read-only.

Auth (state-check first)

Configure your Fireflies API credential using the documented method (never commit or print it):

bash
source "<credential-file>"   # exports API_KEY
[ -n "$API_KEY" ] || echo "MISSING KEY - stop and tell the user"

Every call is a POST to https://api.fireflies.ai/graphql with authentication configured according to Fireflies' API documentation and a JSON body {"query": "..."}.

Step 1 - find the meeting id

bash
curl -sS -X POST https://api.fireflies.ai/graphql \
  -H "Content-Type: application/json" \
  -d '{"query":"{ transcripts(limit: 25) { id title date duration } }"}' \
  | jq -r '.data.transcripts[] | "\(.id) | \(.title) | \(.date)"'
  • date is epoch milliseconds. Convert on macOS: date -r $((1784127600000/1000)).
  • The transcripts(title:) filter is EXACT-match — it returns [] for partial names. List recent meetings and grep locally instead.
  • Ad-hoc meetings have no proper title (e.g. Untitled - Wed, 15 Jul 2026 17:00:55 CEST). Identify those by date/time, then confirm via content or speakers, not the title.
  • Paginate older meetings with skip: (e.g. transcripts(limit: 50, skip: 25)).

Step 2 - pull the raw transcript

bash
QUERY='{ transcript(id: "MEETING_ID") { title sentences { speaker_name text } } }'
curl -sS -X POST https://api.fireflies.ai/graphql \
  -H "Content-Type: application/json" \
  -d "$(jq -nc --arg query "$QUERY" '{query: $query}')" \
  > /tmp/ff.json

# speaker-labeled raw text (usual deliverable)
jq -r '.data.transcript.sentences[] | "\(.speaker_name): \(.text)"' /tmp/ff.json

# bare text only
jq -r '.data.transcript.sentences[].text' /tmp/ff.json

Transcripts run to hundreds of sentences — save to a file, never dump to stdout/chat.

Optional extras on the same transcript(id:) query: summary { overview short_summary keywords }, participants, duration, meeting_link.

Failure modes

  • sentences: null — recording still processing or no audio captured; nothing to pull.
  • errors[] in the response instead of data — usually a bad field name; fix the query.
  • 401/invalid key — key was rotated; ask the user for a new one (Fireflies dashboard: Settings -> Developer settings), update the configured credential file.

Verify before reporting done

A pull is successful only if the sentence count is > 0 and the speakers/topic match the meeting the user asked about — check the first few lines, don't trust the title alone.

© davidondrej, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/research-and-web/fireflies-transcript of davidondrej/skills.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit ea32e5f

Compare with similar skills

Fireflies Transcript next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Fireflies Transcript compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Fireflies Transcript this skilldavidondrej/skills4.1k—~704Automated safety check: PassMIT
Multi-Source to NotebookLM Processorjoeseesun/qiaomu-anything-to-notebooklm6.2k—~3.6kAutomated safety check: PassMIT
Youtube FetcherJimmySadek/youtube-fetcher-to-markdown485—~1.8kAutomated safety check: PassMIT
YouTube Transcript FetcherZeroPointRepo/youtube-skills1k1 repos~1.1kAutomated safety check: PassMIT
Subscription Videos MetadataEfficientStreet/youtube-subscriptions-ingest178—~7.1kAutomated safety check: NotesMIT
YouTube Video TranscriptZeroPointRepo/youtube-skills1k1 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Multi-Source to NotebookLM Processor

    joeseesun/qiaomu-anything-to-notebooklm

    Collects content from WeChat articles, web pages, YouTube, podcasts, documents and more, uploads it to NotebookLM and generates podcasts, slides or mind maps.

    6.2k GitHub stars~3.6k tokensUpdated 2 days ago
    Knowledge ManagementAuto-check passed
  • Youtube Fetcher

    JimmySadek/youtube-fetcher-to-markdown

    Retrieve YouTube transcripts and subtitles, summarize or analyze what was said, or save an Obsidian-ready Markdown knowledge-base note with captions, creator metadata, chapters, language, and source…

    485 GitHub stars~1.8k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check passed
  • YouTube Transcript Fetcher

    ZeroPointRepo/youtube-skills

    Fetches the transcript of a YouTube video through TranscriptAPI.com so the agent can summarize, quote, translate or fact-check what was said.

    1k GitHub starsUsed in 1 repo~1.1k tokens
    Knowledge ManagementAuto-check passed
  • Subscription Videos Metadata

    EfficientStreet/youtube-subscriptions-ingest

    Pull metadata from YouTube subscription videos into a second-brain vault as a real cross-linked knowledge graph — not just a flat archive.

    178 GitHub stars~7.1k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check: notes
  • YouTube Video Transcript

    ZeroPointRepo/youtube-skills

    Fetches YouTube transcripts through TranscriptAPI.com so an agent can summarize, quote or translate a video from a link or ID.

    1k GitHub starsUsed in 1 repo~1.1k tokens
    Knowledge ManagementAuto-check passed
  • Video Lens Gallery

    kar2phi/video-lens

    Open or rebuild the video-lens gallery index — your personal library of saved video summaries.

    112 GitHub stars~608 tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check: notes

More from davidondrej/skills

All 51 skills in this repo
  • Nagent

    davidondrej/skills

    Launch a new bb worker thread with the right project, model, worktree, and task brief.

    4.1k GitHub stars~1.7k tokensUpdated yesterday
    Auto-check: notes
  • Browser Harness

    davidondrej/skills

    Direct browser control via CDP. An agent skill from davidondrej/skills.

    4.1k GitHub starsUsed in 2 repos~3k tokens
    Auto-check passed
  • Persistent Localhost

    davidondrej/skills

    Manage persistent dev servers, APIs, and other local processes on a port using macOS LaunchAgents.

    4.1k GitHub stars~618 tokensUpdated yesterday
    Auto-check passed
  • Reset Cursor Acp

    davidondrej/skills

    Reset a stuck Cursor ACP thread in <chat-system and reload its configuration.

    4.1k GitHub stars~728 tokensUpdated yesterday
    Auto-check passed
  • Anti Sleep

    davidondrej/skills

    Keep a Mac awake for a set duration or while a process runs.

    4.1k GitHub stars~640 tokensUpdated yesterday
    Auto-check: warnings
  • Bb CLI

    davidondrej/skills

    Use this when controlling bb. An agent skill from davidondrej/skills.

    4.1k GitHub stars~823 tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Fireflies Transcript

What does Fireflies Transcript do?

Fetch raw Fireflies.ai meeting transcripts. An agent skill from davidondrej/skills. Fireflies Transcript is an agent skill from davidondrej/skills.ai meeting transcripts.

When should I use Fireflies Transcript?

Fireflies Transcript fits situations like: explicitly invokes /fireflies-transcript; use youtube-transcript.

How do I install Fireflies Transcript in Claude Code?

Run `npx skills add davidondrej/skills --skill fireflies-transcript -a claude-code`. Or copy the skill folder (skills/research-and-web/fireflies-transcript in davidondrej/skills) into .claude/skills/fireflies-transcript in your project. Claude Code loads it when a task matches its description.

How do I install Fireflies Transcript in Codex?

Run `npx skills add davidondrej/skills --skill fireflies-transcript -a codex`. Or copy the skill folder (skills/research-and-web/fireflies-transcript in davidondrej/skills) into .agents/skills/fireflies-transcript in your project. Codex loads it when a task matches its description.

Can I use Fireflies Transcript in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add davidondrej/skills --skill fireflies-transcript -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/fireflies-transcript, .gemini/skills/fireflies-transcript, .github/skills/fireflies-transcript and .opencode/skills/fireflies-transcript in your project.

What does Fireflies Transcript need to run?

Going by SKILL.md and its folder, Fireflies Transcript needs the command-line tools its instructions call (jq and curl) and credentials named API_KEY. Our summary lists: A credential in API_KEY.

Does Fireflies Transcript access the network?

SKILL.md names 1 domain. In commands or code: api.fireflies.ai; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Fireflies Transcript safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Fireflies Transcript use?

Fireflies Transcript is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Fireflies Transcript use?

About 704 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Fireflies Transcript?

Skills that share tags, products or a category with Fireflies Transcript: Multi-Source to NotebookLM Processor (joeseesun/qiaomu-anything-to-notebooklm, 6.2k stars), Youtube Fetcher (JimmySadek/youtube-fetcher-to-markdown, 485 stars), YouTube Transcript Fetcher (ZeroPointRepo/youtube-skills, 1k stars) and Subscription Videos Metadata (EfficientStreet/youtube-subscriptions-ingest, 178 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fireflies Transcript?

davidondrej (a GitHub user) maintains it in davidondrej/skills, which has 4,105 GitHub stars. The repository holds 51 skills in this directory. The repository was last updated on October 6, 2026.

Source: davidondrej/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.