minutes-verify

Verify Minutes CLI, whisper models, directories, audio input, and PID state.

1.4k|146|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/silverstein/minutes --skill minutes-verify
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: minutes-verify
Source: https://github.com/silverstein/minutes/tree/main/tooling/skills/sources/minutes-verify
Command: npx skills add https://github.com/silverstein/minutes --skill minutes-verify

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill confirms that a local Minutes installation is properly configured and ready to record by detecting missing binaries, missing models, absent directories, unavailable audio inputs, and stale PID state that can prevent recording or transcription.

Core Features & Use Cases

  • Binary and model validation: checks that the minutes CLI is on PATH and that at least one whisper model is downloaded.
  • Filesystem and PID checks: verifies ~/meetings and ~/meetings/memos exist and detects stale ~/.minutes/recording.pid files.
  • Audio and config reporting: detects available audio input devices on macOS and reports whether an optional config file exists.
  • Use case: run this after installation or when a user reports "minutes isn't working" to get clear, actionable remediation steps.

Quick Start

Run the verification script included with the skill by executing the verify-setup.sh script in the skill's scripts directory to check models, audio devices, directories, and PID state.

Frequently Asked Questions about minutes-verify

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify my Minutes installation is ready to record?

To verify your Minutes installation, run a health check script that confirms the minutes CLI is on PATH, whisper models are downloaded, and required directories exist. This check ensures all components are configured correctly before you start recording audio.

Why does my minutes command fail to start recording?

Your minutes command might fail due to missing whisper models, absent ~/meetings and ~/meetings/memos directories, unavailable audio input devices on macOS, or a stale recording.pid file in ~/.minutes blocking the process.

What does a Minutes health check look for to prevent transcription errors?

A Minutes health check looks for the minutes binary on PATH, presence of whisper models in ~/.minutes/models or ~/.cache/whisper, valid filesystem directories, available audio input devices, and stale PID state to prevent transcription errors.

Can I use the Minutes setup verification on an MCP server?

Yes, you can use the Minutes setup verification on local desktop and MCP server setups. It checks binaries, models, storage directories, audio inputs, and PID state to confirm the environment is ready for recording or running agents.

How do I check if whisper models are downloaded for my minutes transcription setup?

To check if whisper models are downloaded for your minutes transcription setup, run the verification script. It scans ~/.minutes/models or ~/.cache/whisper to ensure at least one model is present before transcription.

What should I do if Minutes isn't working after installation?

If Minutes isn't working after installation, run the verify-setup.sh script. It checks models, audio devices, directories, and PID state, providing clear, actionable remediation steps for any missing or misconfigured components.