Agent Skills
› silverstein/minutes
› minutes-verify
minutes-verify
GitHub用于验证 Minutes 应用安装环境是否正常的健康检查技能，通过脚本检测二进制、模型、目录及音频状态等组件。
Trigger Scenarios
用户询问 Minutes 是否正常工作
用户要求检查设置或验证安装
测试录音设置
排查 Minutes 无法使用的问题
首次运行设置后
Install
npx skills add silverstein/minutes --skill minutes-verify -g -y
SKILL.md
Frontmatter
{
"name": "minutes-verify",
"description": "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\", or after running setup for the first time."
}
Skill Path
Before running helper scripts or opening bundled references, set:
export MINUTES_SKILLS_ROOT="$(git rev-parse --show-toplevel)/.agents/skills/minutes"
export MINUTES_SKILL_ROOT="$MINUTES_SKILLS_ROOT/minutes-verify"
/minutes-verify
Run a health check on the Minutes installation to confirm everything is working.
How to verify
Run the verification script included with this skill:
bash "$MINUTES_SKILL_ROOT/scripts/verify-setup.sh"
The script checks each component and outputs a pass/fail status for each. Read the output and report results to the user.
What gets checked
| Check | What it verifies |
|---|---|
| Binary | minutes command exists on PATH |
| Model | At least one whisper model downloaded in ~/.minutes/models/ or ~/.cache/whisper/ |
| Meetings dir | ~/meetings/ directory exists |
| Memos dir | ~/meetings/memos/ directory exists |
| PID state | No stale PID file in ~/.minutes/recording.pid |
| Audio input | CLI-context audio input visibility (macOS only; desktop readiness is authoritative for the signed app) |
| Config | ~/.config/minutes/config.toml exists (optional — defaults work fine) |
| Spotlight privacy | macOS .metadata_never_index markers exist for ~/.minutes and ~/meetings when those directories exist |
After verification
If any checks fail, tell the user exactly what to do:
- Binary missing →
cargo build --releasein the minutes repo, then add to PATH - No model →
minutes setup --model small(recommended) or--model tiny(faster, lower quality) - No meetings dir →
mkdir -p ~/meetings/memos— will also be created on first recording - Stale PID →
rm ~/.minutes/recording.pid— previous recording crashed without cleanup - Audio input warning → Treat as CLI-context-only. If the signed desktop app's Readiness Center shows Audio input/Microphone as ready, trust the desktop app identity.
- Spotlight privacy warning → Open the desktop app or run
minutes setupso Minutes can recreate the.metadata_never_indexmarkers.
Gotchas
- The script is macOS-specific for the audio input check (uses
system_profiler). On Linux, that check will be skipped. On macOS, shell-context checks can disagree with the signed desktop app; use the desktop Readiness Center for TCC-sensitive truth. - "Model not found" is the #1 setup issue — most people forget to run
minutes setupafter building. - Config file is optional — if
~/.config/minutes/config.tomldoesn't exist, that's fine. Minutes uses compiled defaults. Only flag it as "not configured" (informational), not as an error. - Spotlight privacy uses folder markers — Minutes verifies
.metadata_never_index; it does not disable Spotlight indexing for the whole user volume.
Version History
- 1dfcb30 Current 2026-07-25 08:25
