Agent skill

Minutes Record

by silverstein in silverstein/minutes

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

MITAuto-check passedMedia & Creative

Install Minutes Record

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

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

GitHub CLI
$ gh skill install silverstein/minutes minutes-record --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-record .claude/skills/minutes-record && 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-record
GitHub stars
1.5k
Token cost
~1.1k tokens
SKILL.md length
513 words
Files
2 (incl. references)
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 4 steps: Stops audio capture → Transcribes the audio locally via… → Saves the transcript as a markdown file… → …
  • Start recording
  • SKILL.md covers Skill Path, How it works, What you get and First-time setup, plus 1 more section
  • Calls git

What it does

Minutes Record is an agent skill from silverstein/minutes. Start or stop recording a meeting, call, or voice memo. Use this whenever the user says "record", "start recording", "capture this meeting", "stop recording", "I'm in a meeting", "take notes on this call", or wants to transcribe live audio. Also use when they ask about recording status or want to know if something is being recorded.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/audio-devices.md`). 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

  • Start recording
  • Capture this meeting
  • Im in a meeting
  • Take notes on this call

Example prompts

  • “record”
  • “start recording”
  • “capture this meeting”
  • “/minutes-record”

Requirements

  • Compatibility (from SKILL.md): opencode

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Stops audio capture
  2. Transcribes the audio locally via whisper.cpp (no cloud, no data leaves the machine)
  3. Saves the transcript as a markdown file in ~/meetings/
  4. Prints the output path and word count as JSON

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

    Shell commands in SKILL.md call:

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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 Record loads about 1.1k tokens when it runs, and up to ~1.9k if it reads all its reference files. Until then it costs about 87 tokens; SKILL.md has 513 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~87
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.9k

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). 513 words, ~1,146 tokens.

Download SKILL.mdSave it as .claude/skills/minutes-record/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
minutes-record
description
Start or stop recording a meeting, call, or voice memo. Use this whenever the user says "record", "start recording", "capture this meeting", "stop recording", "I'm in a meeting", "take notes on this call", or wants to transcribe live audio. Also use when they ask about recording status or want to know if something is being recorded.
compatibility
opencode

Skill Path

Before running helper scripts or opening bundled references, set:

bash
export MINUTES_SKILLS_ROOT="$(git rev-parse --show-toplevel)/.opencode/skills"
export MINUTES_SKILL_ROOT="$MINUTES_SKILLS_ROOT/minutes-record"

/minutes-record

Record audio from the microphone, transcribe it locally with whisper.cpp, and save as searchable markdown.

How it works

Recording is a two-step process — start and stop. Between those two commands, audio is captured continuously from the default input device.

Start recording:

bash
minutes record
# Or with a title:
minutes record --title "Weekly standup with Alex"

The process runs in the foreground. It captures audio from whatever input device is active — the built-in MacBook mic for in-person conversations, or a BlackHole virtual audio device for system audio (Zoom, Meet, Teams calls).

Stop recording:

bash
minutes stop

This sends a signal to the recording process, which then:

  1. Stops audio capture
  2. Transcribes the audio locally via whisper.cpp (no cloud, no data leaves the machine)
  3. Saves the transcript as a markdown file in ~/meetings/
  4. Prints the output path and word count as JSON

Live transcript during recording:

While recording, Minutes streams a real-time transcript to ~/.minutes/live-transcript.jsonl. You can read it with:

bash
minutes transcript                    # all lines
minutes transcript --since 42         # lines after cursor
minutes transcript --since 5m         # last 5 minutes
minutes transcript --status           # check if active

This lets you follow what's being discussed mid-meeting. The live output is rougher than the final transcript produced after stop -- it prioritizes speed over accuracy.

Check status:

bash
minutes status

Returns JSON: {"recording": true, "pid": 12345} or {"recording": false}

What you get

A markdown file at ~/meetings/YYYY-MM-DD-title.md with:

  • YAML frontmatter (title, date, duration, type)
  • Timestamped transcript
  • Summary, decisions, and action items (if LLM summarization is configured)

File permissions are set to 0600 (owner-only) because transcripts contain sensitive content.

First-time setup

If the user hasn't set up minutes before, they need a speech model:

Whisper (default):

bash
minutes setup --model small

This downloads a ~466MB model. For faster but lower quality: --model tiny (75MB). For best quality: --model large-v3 (3.1GB).

Parakeet preferences currently resolve to Whisper on every platform. The pathname-only helper cannot safely receive Minutes' sealed private audio, so setup and selection fail closed until a secure byte transport lands. Do not send users through the Parakeet setup guide as a recording prerequisite.

Show full SKILL.md (202 more words)Show less

Gotchas

  • "model not found" → Run minutes setup --model small. This is the most common first-run error.
  • "already recording" → Run minutes stop first, or minutes status to check. If the PID file is stale (process crashed), minutes stop will clean it up.
  • No audio captured / empty transcript → Check that the right input device is selected in System Settings > Sound. On MacBooks, the default mic works for in-person conversations but won't capture system audio.
  • For Zoom/Meet/Teams audio → You need BlackHole to capture system audio. See references/audio-devices.md in this skill folder for the full setup guide.
  • Recording runs but transcription is garbage → The tiny model is fast but low quality. Upgrade to small or medium for real meetings: minutes setup --model small.
  • "permission denied" on output file → Output files are 0600 (owner-only). This is intentional — transcripts contain sensitive content. Don't chmod them to be world-readable.
  • Long meetings (>2 hours) → Transcription time scales with duration. A 2-hour meeting with the small model takes ~3-5 minutes on Apple Silicon. The tiny model is ~4x faster but much less accurate.
  • Recording process disappeared → If you close the terminal tab where minutes record is running, the recording stops but may not process. Always use minutes stop from another terminal.

© 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

SKILL.md and 1 other file (references) in .opencode/skills/minutes-record of silverstein/minutes.

  • SKILL.md
  • references/audio-devices.md

Open the folder on GitHubat commit d3285c7

Compare with similar skills

Minutes Record 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 Record compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Minutes Record this skillsilverstein/minutes1.5k—~1.1kAutomated safety check: PassMIT
HyperFrames Media Useheygen-com/hyperframes59k—~2.4kAutomated safety check: PassApache-2.0
Native Subtitle Quote Imagechengyi-ai/native-subtitle-quote-image2.4k—~1.8kAutomated safety check: PassMIT
Edu Math Videowy51ai/edulab1.4k—~2.5kAutomated safety check: NotesApache-2.0
Transcription Memory ReconstructionNxcoreAI/EverRoom3k—~714Automated safety check: PassCustom licence
TranscribeJetBrains/skills3664 repos~776Automated safety check: PassApache-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.

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

    chengyi-ai/native-subtitle-quote-image

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

    2.4k GitHub stars~1.8k tokensUpdated today
    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 11 days ago
    Media & CreativeAuto-check: notes
  • Reconstruct a complete, searchable memory from an untrusted meeting or conversation transcript.

    3k GitHub stars~714 tokensUpdated today
    Media & CreativeAuto-check passed
  • 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
  • Bilibili Transcribe

    chubbyguan/chubbyskills

    哔哩哔哩视频 → 下载 → 转录 → 存为 Markdown 的完整工作流. An agent skill from chubbyguan/chubbyskills.

    1.2k GitHub stars~578 tokensUpdated yesterday
    Media & CreativeAuto-check: notes

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 today
    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 today
    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 today
    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 today
    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 today
    Auto-check passed
  • Minutes Cleanup

    silverstein/minutes

    Manage old recordings — find large files, archive old meetings, delete processed originals.

    1.5k GitHub stars~852 tokensUpdated today
    Auto-check passed

Questions about Minutes Record

What does Minutes Record do?

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

When should I use Minutes Record?

Minutes Record fits situations like: start recording; capture this meeting; im in a meeting; take notes on this call.

How do I install Minutes Record in Claude Code?

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

How do I install Minutes Record in Codex?

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

Can I use Minutes Record 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-record -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-record, .gemini/skills/minutes-record, .github/skills/minutes-record and .opencode/skills/minutes-record in your project.

What does Minutes Record need to run?

Going by SKILL.md and its folder, Minutes Record needs the command-line tools its instructions call (git). Compatibility (from SKILL.md): opencode.

Does Minutes Record access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

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

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

About 1.1k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 740 tokens, read only when the agent opens those files.

What are the alternatives to Minutes Record?

Skills that share tags, products or a category with Minutes Record: HyperFrames Media Use (heygen-com/hyperframes, 59k stars), Native Subtitle Quote Image (chengyi-ai/native-subtitle-quote-image, 2.4k stars), Edu Math 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 Record?

silverstein (a GitHub user) maintains it in silverstein/minutes, which has 1,541 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.