Agent skill

Minutes Search

by silverstein in silverstein/minutes

Search past meeting transcripts and voice memos for specific topics, people, decisions, or ideas.

MITAuto-check passedMedia & Creative

Install Minutes Search

skills CLI
$ npx skills add silverstein/minutes --skill minutes-search -a claude-code

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

GitHub CLI
$ gh skill install silverstein/minutes minutes-search --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/silverstein/minutes.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.opencode/skills/minutes-search .claude/skills/minutes-search && 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
minutes-search
GitHub stars
1.5k
Token cost
~1.2k tokens
SKILL.md length
572 words
Files
1
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

Search past meeting transcripts and voice memos for specific topics, people, decisions, or ideas.

  • Asks what did we discuss about X
  • SKILL.md covers Usage, Flags, Output and How search works, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Find that meeting where we talked about Y

What it does

Minutes Search is an agent skill from silverstein/minutes. Search past meeting transcripts and voice memos for specific topics, people, decisions, or ideas. Use this whenever the user asks "what did we discuss about X", "find that meeting where we talked about Y", "what did Alex say", "did we decide on", "what was that idea about", or any question that could be answered by searching their meeting history. Also use for "do I have any notes about" or "check my meetings for".

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: opencode

It sits in Media & Creative, covering Transcription. The repository describes itself as: Open-source, local-first Granola/Otter alternative that Claude Code, Codex, Cursor, and any MCP client can query. Meetings, calls, and voice memos transcribed on-device into… The licence is MIT.

When your agent uses it

  • Asks what did we discuss about X
  • Find that meeting where we talked about Y
  • What did Alex say
  • Did we decide on

Example prompts

  • “what did we discuss about X”
  • “find that meeting where we talked about Y”
  • “what did Alex say”
  • “/minutes-search”

Requirements

  • Compatibility (from SKILL.md): opencode

What it can do on your machine

Read from SKILL.md and the folder at commit d3285c7. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash and toml).

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

  • Compatibility

    opencode

    From compatibility in the SKILL.md frontmatter.

Context cost

Minutes Search loads about 1.2k tokens when it runs. Until then it costs about 108 tokens; SKILL.md has 572 words of instructions outside code blocks.

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

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 silverstein/minutes at commit d3285c7, republished under its MIT licence (© silverstein). 572 words, ~1,207 tokens.

Download SKILL.mdSave it as .claude/skills/minutes-search/SKILL.md (or your agent's skills folder).
name
minutes-search
description
Search past meeting transcripts and voice memos for specific topics, people, decisions, or ideas. Use this whenever the user asks "what did we discuss about X", "find that meeting where we talked about Y", "what did Alex say", "did we decide on", "what was that idea about", or any question that could be answered by searching their meeting history. Also use for "do I have any notes about" or "check my meetings for".
compatibility
opencode

Find information across all meeting transcripts and voice memos.

Usage

bash
# Basic search
minutes search "pricing strategy"

# Filter to just voice memos
minutes search "onboarding idea" -t memo

# Filter to just meetings
minutes search "sprint planning" -t meeting

# Date filter + limit
minutes search "API redesign" --since 2026-03-01 --limit 5

Flags

FlagDescription
-t, --content-type <meeting|memo>Filter by type
--since <date>Only results after this date (ISO format, e.g., 2026-03-01)
-l, --limit <n>Maximum results (default: 10)

Output

Returns JSON to stdout with an array of matches. Each result includes:

  • title — Meeting or memo title
  • date — When it was recorded
  • content_type — "meeting" or "memo"
  • snippet — The line containing the match
  • path — Full path to the markdown file

Human-readable output goes to stderr. A result path is only a hint. To read the full transcript, run minutes get "<exact path>" --json, require exit status 0, and use only that response. Never pass the path to cat or the host Read tool.

How search works

Search is case-insensitive and matches against both the transcript body and the YAML frontmatter title. It walks all .md files in ~/meetings/ (including the memos/ subfolder).

For richer semantic search, users can configure QMD as the search engine in ~/.config/minutes/config.toml:

toml
[search]
engine = "qmd"
qmd_collection = "meetings"

Search coaching

When the user's search query is vague or too broad, push back before running it:

  • "who said X" or "what did Alex say" → If the meeting has speaker_map in frontmatter, use it to identify who said what. speaker_map maps SPEAKER_X labels to real names. High confidence = reliable, Medium = "likely" (suggest minutes confirm to lock it in).
  • "everything" or "all meetings" → "That'll return hundreds of results. What specifically are you looking for? A person, a topic, or a decision?"
  • Single common word like "meeting" or "project" → "That's too broad. Can you narrow it — a person's name, a specific topic, or a date range?"
  • "that meeting" or "the one where" → "Help me narrow it down. Do you remember who was in the meeting, roughly when it was, or a specific thing that was said?"

Suggest search strategies based on what the user is looking for:

  • Finding a person's input → Search their name: minutes search "Alex"
  • Finding a decision → Search decision keywords: minutes search "decided" or minutes search "agreed"
  • Finding an idea → Search voice memos: minutes search "idea" -t memo
  • Finding something from a time range → Use --since: minutes search "pricing" --since 2026-03-01
Show full SKILL.md (216 more words)Show less

Tips for good searches

  • Search for what people said, not document titles: "we should postpone the launch" not "launch delay meeting"
  • Search for names to find the policy-authorized normal history involving someone: "Alex" or "Case"
  • Search for decisions: "decided", "agreed", "committed to"
  • Reauthorize a selected result with minutes get "<exact path>" --json before loading full context

Gotchas

  • Search is substring, not fuzzy — "price" matches "pricing" and "price", but "prcing" (typo) matches nothing. Try multiple terms if you're not sure of the exact wording.
  • --since requires ISO date format — Use 2026-03-01, not "last week" or "March 1st". For relative dates, compute the ISO date first: date -v-7d +%Y-%m-%d.
  • Large result sets flood stdout — Always use --limit when searching broad terms. The default limit is 10, but common words can match hundreds of files.
  • QMD semantic search requires separate setup — If config.toml sets engine = "qmd" but the QMD collection isn't indexed, search will fail silently. Run qmd update && qmd embed first.
  • Voice memos vs meetings — Both are searched by default. Use -t memo or -t meeting to narrow results. Voice memos live in ~/meetings/memos/, meetings in ~/meetings/.
  • Empty results don't mean it wasn't discussed — If the meeting wasn't transcribed (e.g., recording was stopped before processing), it won't appear in search. Check minutes list to see what's been processed.

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

Files

Just SKILL.md in .opencode/skills/minutes-search of silverstein/minutes.

Open the folder on GitHubat commit d3285c7

Compare with similar skills

Minutes Search 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.

Minutes Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Minutes Search this skillsilverstein/minutes1.5k—~1.2kAutomated safety check: PassMIT
HyperFrames Media Useheygen-com/hyperframes60k—~2.4kAutomated safety check: PassApache-2.0
Native Subtitle Quote Imagechengyi-ai/native-subtitle-quote-image2.6k—~2.4kAutomated safety check: PassMIT
Edu Chem Videowy51ai/edulab1.4k—~2.1kAutomated safety check: NotesApache-2.0
Transcription Memory ReconstructionNxcoreAI/EverRoom3k—~714Automated safety check: PassCustom licence
Edu Math Videowy51ai/edulab1.4k—~2.5kAutomated safety check: NotesApache-2.0

Similar skills

  • HyperFrames Media Use

    heygen-com/hyperframes

    Finds, generates and edits media for HyperFrames video projects: music, sound effects, images, icons, logos, voiceovers, captions and color grades.

    60k GitHub stars~2.4k tokensUpdated today
    Media & CreativeAuto-check passed
  • Native Subtitle Quote Image

    chengyi-ai/native-subtitle-quote-image

    将本地视频或用户有权处理的在线视频,经过来源获取、文字稿定位、选题选句、精确取帧、紧凑裁切、拼图和逐张质检,制作成 3:4 或保留画面原比例的视频字幕长图。支持两种明确分开的输出:保留画面内已烧录字幕的原生字幕模式,以及把已审核的时间点与台词绘制到真实视频帧上的脚本字幕模式。用户要求原生字幕截图、字幕帧拼图、YouTube…

    2.6k GitHub stars~2.4k tokensUpdated today
    Media & CreativeAuto-check passed
  • Edu Chem Video

    wy51ai/edulab

    A skill your agent uses when asked to make an explainer / walkthrough video (讲解视频、解题视频、例题精讲、微课) for a chemistry problem (化学题: 氧化还原配平 双线桥 电子守恒, 物质的量计算, 化学平衡 三段式 平衡常数 转化率 反应速率, 离子反应, 电化学, 溶液 滴定…

    1.4k GitHub stars~2.1k tokensUpdated yesterday
    Media & CreativeAuto-check: notes
  • Reconstruct a complete, searchable memory from an untrusted meeting or conversation transcript.

    3k GitHub stars~714 tokensUpdated 2 days ago
    Media & CreativeAuto-check passed
  • Edu Math Video

    wy51ai/edulab

    A skill your agent uses when asked to make an explainer / walkthrough video (讲解视频、解题视频、例题精讲、微课) for a math problem (数学题, geometry, algebra, functions, motion/行程 problems), from a problem screenshot…

    1.4k GitHub stars~2.5k tokensUpdated yesterday
    Media & CreativeAuto-check: notes
  • Transcribe

    JetBrains/skills

    Official

    Transcribe audio files to text with optional diarization and known-speaker hints.

    366 GitHub starsUsed in 4 repos~776 tokens
    Media & CreativeAuto-check passed

More from silverstein/minutes

All 24 skills in this repo
  • Minutes Video Review

    silverstein/minutes

    Analyze a product walkthrough, bug report video, Loom, or ScreenPal using Minutes transcription plus visual review.

    1.5k GitHub stars~1.4k tokensUpdated 2 days ago
    Auto-check: notes
  • Minutes Mirror

    silverstein/minutes

    Self-coaching analysis of your own behavior across meetings — talk-time ratio, filler words, hedging language, monologue length, energy patterns, and (when meetings are tagged via /minutes-tag) what…

    1.5k GitHub stars~3.5k tokensUpdated 2 days ago
    Auto-check passed
  • Minutes Tag

    silverstein/minutes

    Lightweight outcome tagging for meetings — won, lost, stalled, great, or noise.

    1.5k GitHub stars~2.2k tokensUpdated 2 days ago
    Auto-check passed
  • Minutes Verify

    silverstein/minutes

    Verify that Minutes is properly set up and working — model downloaded, mic accessible, directories exist, no stale state.

    1.5k GitHub stars~801 tokensUpdated 2 days ago
    Auto-check passed
  • Minutes Record

    silverstein/minutes

    Start or stop recording a meeting, call, or voice memo. An agent skill from silverstein/minutes.

    1.5k GitHub stars~1.1k tokensUpdated 2 days ago
    Auto-check passed
  • Minutes Brief

    silverstein/minutes

    Fast non-interactive briefing before any meeting — auto-detects your next calendar event, pulls relationship history, surfaces open commitments, and produces a one-page brief in under 30 seconds.

    1.5k GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check passed

Questions about Minutes Search

What does Minutes Search do?

Search past meeting transcripts and voice memos for specific topics, people, decisions, or ideas. Minutes Search is an agent skill from silverstein/minutes. Search past meeting transcripts and voice memos for specific topics, people, decisions, or ideas.

When should I use Minutes Search?

Minutes Search fits situations like: asks what did we discuss about X; find that meeting where we talked about Y; what did Alex say; did we decide on.

How do I install Minutes Search in Claude Code?

Run `npx skills add silverstein/minutes --skill minutes-search -a claude-code`. Or copy the skill folder (.opencode/skills/minutes-search in silverstein/minutes) into .claude/skills/minutes-search in your project. Claude Code loads it when a task matches its description.

How do I install Minutes Search in Codex?

Run `npx skills add silverstein/minutes --skill minutes-search -a codex`. Or copy the skill folder (.opencode/skills/minutes-search in silverstein/minutes) into .agents/skills/minutes-search in your project. Codex loads it when a task matches its description.

Can I use Minutes Search 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 silverstein/minutes --skill minutes-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/minutes-search, .gemini/skills/minutes-search, .github/skills/minutes-search and .opencode/skills/minutes-search in your project.

What does Minutes Search need to run?

SKILL.md names no scripts, command-line tools or credentials: Minutes Search is instructions for the agent only. Compatibility (from SKILL.md): opencode.

Does Minutes Search access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Minutes Search 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 Minutes Search use?

Minutes Search 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 Minutes Search use?

About 1.2k tokens (SKILL.md is roughly 4.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 Minutes Search?

Skills that share tags, products or a category with Minutes Search: HyperFrames Media Use (heygen-com/hyperframes, 60k stars), Native Subtitle Quote Image (chengyi-ai/native-subtitle-quote-image, 2.6k stars), Edu Chem Video (wy51ai/edulab, 1.4k stars) and Transcription Memory Reconstruction (NxcoreAI/EverRoom, 3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Minutes Search?

silverstein (a GitHub user) maintains it in silverstein/minutes, which has 1,542 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 8, 2026.

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