AgentSkillsCN

ff-search

在会议转录文本中执行全文检索。在查找特定内容、发言人或问题时使用。

SKILL.md
--- frontmatter
name: ff-search
description: Full-text search across meeting transcripts. Use when finding specific content, speakers, or questions.
allowed-tools: Bash(npm exec --yes --package=fireflies-api -- fireflies-api search *)

Fireflies Search

Full-text search across meeting transcripts.

Command

bash
npm exec --yes --package=fireflies-api -- fireflies-api search <query> [options]

Options

Date Shortcuts (prefer these over --from/--to):

  • --today - Today's transcripts
  • --yesterday - Yesterday's transcripts
  • --last-week - Last 7 days
  • --last-month - Last 30 days
  • --days <n> - Last N days

Search Filters:

  • --speaker <name> - Filter by speaker name
  • --questions - Search only questions
  • --tasks - Search only task-related content
  • --context - Include surrounding context
  • --limit <n> - Number of results
  • --from <date> - Start date (YYYY-MM-DD) - only if shortcuts don't fit
  • --to <date> - End date (YYYY-MM-DD) - only if shortcuts don't fit
  • -o, --output <format> - Output format: json, jsonl, table, tsv, plain

Examples

bash
# Basic search
npm exec --yes --package=fireflies-api -- fireflies-api search "budget"

# Search with speaker filter
npm exec --yes --package=fireflies-api -- fireflies-api search "proposal" --speaker "John"

# Search questions from last week
npm exec --yes --package=fireflies-api -- fireflies-api search "deadline" --questions --last-week

# Search with context
npm exec --yes --package=fireflies-api -- fireflies-api search "action item" --context --limit 20

Instructions

  1. Verify API key is set:

    bash
    test -n "$FIREFLIES_API_KEY" && echo "Ready" || echo "ERROR: Set FIREFLIES_API_KEY"
    
  2. Execute the search command with the user's query and any relevant filters.

  3. Suggest appropriate filters based on the user's intent (e.g., --questions for finding Q&A).

Usage Tips

Output Format:

  • Use -o plain for human-readable output with context
  • Use -o table for compact tabular view
  • Only use -o json if user needs structured data

When to Use Search:

  • Finding specific content across many transcripts (efficient - single call)
  • Finding who said something, questions asked, or action items mentioned
  • More efficient than listing transcripts + getting each one