Skip to content
cccskills
FreePublished on GitHub

minutes-setup

Guided first-time setup for Minutes — download whisper model, create directories, configure audio input. Use when the user says "set up minutes", "install minutes", "first time setup", "configure minutes", "get started with minutes", "how do I start using minutes", or when verify shows missing components.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md2.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

/minutes-setup

Walk the user through first-time Minutes setup, step by step.

Setup steps

1. Check current state first

Run the verify skill's script to see what's already done:

bash "${CLAUDE_PLUGIN_ROOT}/skills/minutes-verify/scripts/verify-setup.sh"

Skip any steps that already pass.

2. Build the binary (if needed)

cd ~/Sites/minutes
export CXXFLAGS="-I$(xcrun --show-sdk-path)/usr/include/c++/v1"
cargo build --release

The binary lands at target/release/minutes. The user should add it to their PATH or create a symlink.

3. Download a whisper model

Ask the user which quality level they want using AskUserQuestion:

ModelSizeSpeedQualityBest for
tiny75 MB~10x real-timeLowQuick tests, short memos
small466 MB~4x real-timeGoodDaily meetings (recommended)
medium1.5 GB~2x real-timeGreatImportant meetings, accents
large-v33.1 GB~1x real-timeBestLegal, medical, foreign language

Then run:

minutes setup --model <chosen-model>

4. Create directories

mkdir -p ~/meetings/memos

5. Audio input (if recording calls)

For in-person conversations, the built-in mic works fine. For Zoom/Meet/Teams:

  1. Install BlackHole: brew install blackhole-2ch
  2. Open Audio MIDI Setup (Spotlight → "Audio MIDI Setup")
  3. Create a Multi-Output Device combining speakers + BlackHole
  4. Set the Multi-Output Device as system output
  5. Set BlackHole as Minutes' input (or system default input)

See minutes-record/references/audio-devices.md for the full guide.

6. Verify

Run verify again to confirm everything passes:

bash "${CLAUDE_PLUGIN_ROOT}/skills/minutes-verify/scripts/verify-setup.sh"

7. Test recording

minutes record --title "Test recording"
# Speak for 10-15 seconds
minutes stop

Check the output file exists in ~/meetings/ and has a transcript.

Gotchas

  • macOS 26 (Tahoe) requires CXXFLAGS — The whisper.cpp build needs the C++ include path set explicitly. This is a known Apple SDK issue.
  • First model download can be slow — The small model is 466 MB. On slow connections, tiny is a good starting point (75 MB).
  • BlackHole setup is the hardest part — Most users struggle with the Audio MIDI Setup step. Offer to walk through it if they get stuck.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

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. Use this whenever the user says "brief me", "give me a quick brief", "what's coming up", "background on my next call", "who am I meeting next", "brief me on Sarah", "I have a call in 10 min", "quick rundown", or right before walking into a meeting. Different from /minutes-prep — brief is the fast hook-fireable version that doesn't ask questions and doesn't set goals. Use brief when speed matters; use prep when the user wants to think hard about goals first.

The English summary is being prepared. Showing the original description.

silverstein/minutes1.6KUpdated Oct 17, 2026

Manage old recordings — find large files, archive old meetings, delete processed originals. Use when the user says "clean up recordings", "how much space are meetings using", "delete old recordings", "archive meetings", "manage meeting storage", or asks about disk space from minutes.

The English summary is being prepared. Showing the original description.

silverstein/minutes1.6KUpdated Oct 17, 2026

Start and control Minutes Coach, the separate real-time copilot HUD, with an explicit meeting goal. Use only for explicit Coach or HUD lifecycle requests such as "start Minutes Coach", "open the Coach HUD", "pause Minutes Coach", "resume Minutes Coach", "Minutes Coach status", or "stop Minutes Coach". Do not use for requests that explicitly ask the current terminal agent to watch or strategize; those belong to minutes-live-sidekick. An ambiguous request such as "coach me live" requires one short surface clarification and must not automatically start Coach.

The English summary is being prepared. Showing the original description.

silverstein/minutes1.6KUpdated Oct 17, 2026

Post-meeting debrief — analyzes what happened, compares outcomes to your prep intentions, tracks decision evolution. Use when the user says "debrief", "what just happened in that meeting", "what did we decide", "debrief that call", "post-meeting", "what changed", or right after stopping a recording.

The English summary is being prepared. Showing the original description.

silverstein/minutes1.6KUpdated Oct 17, 2026

Policy-safe relationship rankings, commitments, aliases, person profiles, and topic research. Always use Minutes' bounded native CLI surfaces; never build or read a durable graph cache.

The English summary is being prepared. Showing the original description.

silverstein/minutes1.6KUpdated Oct 17, 2026

Surface recent voice memos and ideas captured from any device. Use when the user asks "what ideas did I have?", "what were my recent memos?", "what did I record while walking?", or wants to recall a captured thought.

The English summary is being prepared. Showing the original description.

silverstein/minutes1.6KUpdated Oct 17, 2026

See all skills by silverstein

Report a problem with this skill