Skip to content
Skills Library
Personal productivity · Automation

minutes-setup

/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.

Repository
minutes ↗
Licence
MIT
Last repository change
25.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 25.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

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.

Triggers from the description

set up minutesinstall minutesfirst time setupconfigure minutesget started with minuteshow do I start using minutes
Original author description

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.

How it works

  1. Setup steps
  2. Gotchas
Original SKILL.md headings · 84 lines, 369 words
SKILL.md preview
---
name: minutes-setup
description: 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.
user_invocable: true
---

# /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
bash "${CLAUDE_PLUGIN_ROOT}/skills/minutes-verify/scripts/verify-setup.sh"
```

Skip any steps that already pass.

### 2. Build the binary (if needed)

```bash
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:
```bash
minutes setup --model <chosen-model>
```

### 4. Create directories

```bash
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
bash "${CLAUDE_PLUGIN_ROOT}/skills/minutes-verify/scripts/verify-setup.sh"
```

### 7. Test recording

```bash
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.

Versions

RepositoryScoreLicence
This page · silverstein/minutes100MIT
silverstein/minutes100MIT
silverstein/minutes100MIT

Identical content appears in 2 other GitHub folders. We show one copy with the highest score.

Database snapshot: 13.11.2026 · package version e60916d01f9a (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100minutes-verify
    Verify that Minutes is properly set up and working — model downloaded, mic accessible, directories exist, no stale state. Use when the user says "is minutes working", "check my setup", "verify minutes", "test recording setup", "why isn't minutes working", "minutes health check",…
  • 100minutes-verify
    Verify that Minutes is properly set up and working — model downloaded, mic accessible, directories exist, no stale state. Use when the user says "is minutes working", "check my setup", "verify minutes", "test recording setup", "why isn't minutes working", "minutes health check",…
  • 90configure
    Set up the Telegram channel — save the bot token, choose the voice-transcription (Whisper) model, and review access policy. Use when the user pastes a Telegram bot token, asks to configure Telegram, asks "how do I set this up" / "who can reach me", wants to pick or download a…
  • 85setup-watch-for-me
    Configure Watch for Me for a user or repository, including target language, output location, local Whisper, and local speaker diarization. Use for initial setup, reconfiguration, or missing runtime/model configuration.
  • 100setup
    First-run setup, start to finish. Use when the user says /setup, "set this up", "get me started", "help me use this", hands you this repository for the first time, or when data/profile.json does not exist. Installs what is missing, builds the profile from the resume and a short…
  • 100voice-to-text-config
    Set up Telegram voice message transcription — checks faster-whisper installation, downloads the Whisper model, and verifies the hook works end-to-end. Use when the user asks to "set up voice transcription", "configure whisper", "fix voice messages", or when the transcription…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.