Minutes Setup Agent Skill
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.
Install
one command, takes just this skill from the repositorynpx skills add https://github.com/silverstein/minutes --skill minutes-setupThe instruction itself
11 sections, as written by the authorSkill Path
Before running helper scripts or opening bundled references, set:
export MINUTES_SKILLS_ROOT="$(git rev-parse --show-toplevel)/.opencode/skills"
export MINUTES_SKILL_ROOT="$MINUTES_SKILLS_ROOT/minutes-setup"
/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 "$MINUTES_SKILLS_ROOT/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:
| Model | Size | Speed | Quality | Best for |
|-------|------|-------|---------|----------|
| tiny | 75 MB | ~10x real-time | Low | Quick tests, short memos |
| small | 466 MB | ~4x real-time | Good | Daily meetings (recommended) |
| medium | 1.5 GB | ~2x real-time | Great | Important meetings, accents |
| large-v3 | 3.1 GB | ~1x real-time | Best | Legal, 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:
- Install BlackHole:
brew install blackhole-2ch - Open Audio MIDI Setup (Spotlight → "Audio MIDI Setup")
- Create a Multi-Output Device combining speakers + BlackHole
- Set the Multi-Output Device as system output
- 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 "$MINUTES_SKILLS_ROOT/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
smallmodel is 466 MB. On slow connections,tinyis 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.
Other skills for the same job
different authors, same section of the catalogue
Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.
Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.
Improves the quality of images, especially screenshots, by enhancing resolution, sharpness, and clarity. Perfect for preparing images for presentations, documentation, or social media posts.
Create and edit JSON Canvas files (.canvas) with nodes, edges, groups, and connections. Use when working with .canvas files, creating visual canvases, mind maps, flowcharts, or when the user mentions Canvas files in Obsidian.
Publish Markdown articles to X (Twitter) Articles editor with proper formatting. Use when user wants to publish a Markdown file/URL to X Articles, or mentions "publish to X", "post article to Twitter", "X article", or wants help with X Premium article publishing. Handles cover image upload and converts Markdown to rich text automatically.
Downloads videos from YouTube and other platforms for offline viewing, editing, or archival. Handles various formats and quality options.
Teaches the AI to design like a high-end agency. Defines the exact fonts, spacing, shadows, card structures, and animations that make a website feel expensive. Blocks all the common defaults that make AI designs look cheap or generic.
Lightweight WSI tile extraction and preprocessing. Use for basic slide processing tissue detection, tile extraction, stain normalization for H&E images. Best for simple pipelines, dataset preparation, quick tile-based analysis. For advanced spatial proteomics, multiplexed imaging, or deep learning pipelines use pathml.
How to use it
Take silverstein/minutes-.opencode-minutes-setup from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.
The instructions reference brew.
Without those the skill loads but fails at the first command.