← Back to Skills Marketplace
codes71

Firefly AI

by codes71 · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
678
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install firefly
Description
Fetch meeting transcripts, summaries, and action items from Firefly AI (fireflies.ai). Use when the user asks about meetings, transcripts, meeting notes, act...
README (SKILL.md)

Firefly AI Integration

Pull meeting data from Firefly AI via their GraphQL API.

Setup

Requires FIREFLY_API_KEY environment variable. Store in gateway env config.

Usage

Run the script at scripts/firefly.cjs with Node.js:

FIREFLY_API_KEY=\x3Ckey> node scripts/firefly.cjs \x3Ccommand> [options]

Commands

  • list — List recent meetings. Options: --days \x3Cn> (default 14), --limit \x3Cn> (default 50)
  • transcript — Full transcript with timestamps. Requires --id \x3Cmeeting_id>
  • summary — Meeting summary, overview, and action items. Requires --id \x3Cmeeting_id>
  • search — Search by keyword in titles/content. Requires --keyword \x3Ctext>, optional --limit \x3Cn>

Workflow

  1. Use list to find meetings and get IDs
  2. Use summary or transcript with the ID to get details
  3. Use search to find meetings by topic

For custom queries

Build GraphQL queries directly against https://api.fireflies.ai/graphql. See references/api.md for full schema and available fields.

Large transcripts

Full transcripts can be very long (2000+ sentences). When a user asks for a transcript:

  • Save to a file in the workspace if they want to keep it
  • Summarize or extract relevant sections if they want specific info
  • Show a preview (first ~50 lines) and ask if they want more
Usage Guidance
This skill appears to be a straightforward Fireflies.ai client, but the package metadata omits two important runtime requirements: FIREFLY_API_KEY (required by the script) and Node.js (to run scripts/firefly.cjs). Before installing: 1) Verify the skill source/publisher (homepage is missing). 2) Only provide a Fireflies API key you trust the skill with — prefer a scoped or read-only key if Fireflies supports that. 3) Understand that transcripts may contain sensitive personal or company data; if you run the script or save outputs to the workspace, treat those files as sensitive. 4) Consider reviewing the included script locally (it is small and readable) or running it in a restricted environment. 5) Ask the publisher to correct the registry metadata so required env vars and runtime dependencies are declared.
Capability Analysis
Type: OpenClaw Skill Name: firefly Version: 1.0.0 The skill bundle provides a Node.js client (`scripts/firefly.cjs`) to interact with the Firefly AI GraphQL API, as described in `SKILL.md` and `references/api.md`. The script correctly uses environment variables for API keys, parameterizes user inputs for GraphQL queries to prevent injection, and only makes network requests to the specified `api.fireflies.ai` endpoint. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, obfuscation, or prompt injection designed to subvert the agent's intended behavior. The instructions in `SKILL.md` are aligned with the skill's stated purpose and do not contain malicious directives.
Capability Assessment
Purpose & Capability
The code and SKILL.md implement a Fireflies.ai GraphQL client (list, transcript, summary, search) and require an API key — this matches the skill description. However, registry metadata lists no required env vars or binaries while both SKILL.md and the script require FIREFLY_API_KEY and Node.js respectively (inconsistency).
Instruction Scope
Runtime instructions are scoped to calling https://api.fireflies.ai/graphql with an Authorization: Bearer <API_KEY> header and presenting results. The SKILL.md suggests saving large transcripts to the workspace if the user requests that, but the included script itself prints to stdout and does not autonomously write files or send data to any other endpoint.
Install Mechanism
There is no install spec (instruction-only) and the script is included in the package — low installation risk. One metadata omission: the registry does not declare Node.js as a required binary even though the SKILL.md and script require running with node.
Credentials
The skill legitimately needs a single credential (FIREFLY_API_KEY) to call Fireflies.ai. However, the registry metadata lists no required environment variables and no primary credential, so the manifest underreports the sensitive access this skill needs. Confirm the gateway will store the API key securely and that the key scope is limited.
Persistence & Privilege
The skill does not request always:true, does not modify other skills or system settings, and does not persist credentials itself. Autonomous invocation is allowed (platform default) but is not combined here with other elevated privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install firefly
  3. After installation, invoke the skill by name or use /firefly
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: list meetings, full transcripts, summaries with action items, keyword search via Firefly AI GraphQL API
Metadata
Slug firefly
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Firefly AI?

Fetch meeting transcripts, summaries, and action items from Firefly AI (fireflies.ai). Use when the user asks about meetings, transcripts, meeting notes, act... It is an AI Agent Skill for Claude Code / OpenClaw, with 678 downloads so far.

How do I install Firefly AI?

Run "/install firefly" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Firefly AI free?

Yes, Firefly AI is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Firefly AI support?

Firefly AI is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Firefly AI?

It is built and maintained by codes71 (@codes71); the current version is v1.0.0.

💬 Comments