Agent skill

Minutes Verify

by silverstein in silverstein/minutes

Verify that Minutes is properly set up and working — model downloaded, mic accessible, directories exist, no stale state.

MITAuto-check passed

Install Minutes Verify

skills CLI
$ npx skills add silverstein/minutes --skill minutes-verify -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install silverstein/minutes minutes-verify --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/silverstein/minutes.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.opencode/skills/minutes-verify .claude/skills/minutes-verify && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
minutes-verify
GitHub stars
1.5k
Token cost
~801 tokens
SKILL.md length
337 words
Files
2 (incl. scripts)
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

Verify that Minutes is properly set up and working — model downloaded, mic accessible, directories exist, no stale state.

  • The user says is minutes working
  • SKILL.md covers Skill Path, How to verify, What gets checked and After verification, plus 1 more section
  • Runs Shell scripts from its folder; calls git, bash and cargo
  • Test recording setup

What it does

Minutes Verify is an agent skill from silverstein/minutes. 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.

Its SKILL.md is about 800 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/verify-setup.sh`). Compatibility notes: opencode

It works with macOS. The repository describes itself as: Open-source, local-first Granola/Otter alternative that Claude Code, Codex, Cursor, and any MCP client can query. Meetings, calls, and voice memos transcribed on-device into… The licence is MIT.

When your agent uses it

  • The user says is minutes working
  • Test recording setup
  • Why isnt minutes working
  • Minutes health check

Example prompts

  • “is minutes working”
  • “check my setup”
  • “verify minutes”
  • “/minutes-verify”

Requirements

  • A Bash shell
  • Compatibility (from SKILL.md): opencode

What it can do on your machine

Read from SKILL.md and the folder at commit d3285c7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • git
    • bash
    • cargo

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    opencode

    From compatibility in the SKILL.md frontmatter.

Context cost

Minutes Verify loads about 801 tokens when it runs. Until then it costs about 84 tokens; SKILL.md has 337 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~84
When it runs · the whole SKILL.md, loaded when a task matches
~801

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from silverstein/minutes at commit d3285c7, republished under its MIT licence (© silverstein). 337 words, ~801 tokens.

Download SKILL.mdSave it as .claude/skills/minutes-verify/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
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.
compatibility
opencode

Skill Path

Before running helper scripts or opening bundled references, set:

bash
export MINUTES_SKILLS_ROOT="$(git rev-parse --show-toplevel)/.opencode/skills"
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
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

CheckWhat it verifies
Binaryminutes command exists on PATH
ModelAt least one whisper model downloaded in ~/.minutes/models/ or ~/.cache/whisper/
Meetings dir~/meetings/ directory exists
Memos dir~/meetings/memos/ directory exists
PID stateNo stale PID file in ~/.minutes/recording.pid
Audio inputCLI-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 privacymacOS .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 --release in 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 setup so Minutes can recreate the .metadata_never_index markers.

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 setup after building.
  • Config file is optional — if ~/.config/minutes/config.toml doesn'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.

© silverstein, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in .opencode/skills/minutes-verify of silverstein/minutes.

  • SKILL.md
  • scripts/verify-setup.sh

Open the folder on GitHubat commit d3285c7

Compare with similar skills

Minutes Verify next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Minutes Verify compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Minutes Verify this skillsilverstein/minutes1.5k—~801Automated safety check: PassMIT
Site ArchitectureAvdLee/RocketSimApp80411 repos~3.3kAutomated safety check: PassCustom licence
Engine Whats Newflutter/flutter179k—~978Automated safety check: PassBSD-3-Clause
macOS Spm App PackagingDimillian/Skills4k5 repos~1.2kAutomated safety check: PassMIT
Openclaw Live Updateropenclaw/openclaw392k—~3.7kAutomated safety check: PassMIT
Orca iOS Simulator Controlstablyai/orca88k1 repos~584Automated safety check: PassApache-2.0

Similar skills

  • Site Architecture

    AvdLee/RocketSimApp

    When the user wants to plan, map, or restructure their website's page hierarchy, navigation, URL structure, or internal linking.

    804 GitHub starsUsed in 11 repos~3.3k tokens
    Marketing & SEOAuto-check passed
  • Engine Whats New

    flutter/flutter

    Generates the "what's new" release summary and diff file for changes in the Flutter engine (//engine/src/flutter) between two releases (e.g., 3.47 vs 3.44).

    179k GitHub stars~978 tokensUpdated today
    MobileAuto-check passed
  • macOS Spm App Packaging

    Dimillian/Skills

    Scaffold, build, and package SwiftPM-based macOS apps without an Xcode project.

    4k GitHub starsUsed in 5 repos~1.2k tokens
    MobileAuto-check passed
  • Openclaw Live Updater

    openclaw/openclaw

    Maintain the canonical live OpenClaw main checkout, macOS LaunchAgent-managed Gateway, local macOS app, exact-head main CI, and recurring full release validation.

    392k GitHub stars~3.7k tokensUpdated today
    DevOps & CloudAuto-check passed
  • iOS Simulator control from inside Orca, with the live device view in Orca's emulator pane. Use when driving a booted Apple Simulator on macOS: taps, gestures…

    88k GitHub starsUsed in 1 repo~584 tokens
    MobileAuto-check passed
  • A catalog of recurring bug shapes in the Mole Mac cleaner, used to review safety-sensitive diffs for deletion safety, unbounded commands, shell traps and weak tests.

    70k GitHub stars~2k tokensUpdated today
    DevelopmentAuto-check passed

More from silverstein/minutes

All 24 skills in this repo
  • Minutes Video Review

    silverstein/minutes

    Analyze a product walkthrough, bug report video, Loom, or ScreenPal using Minutes transcription plus visual review.

    1.5k GitHub stars~1.4k tokensUpdated yesterday
    Auto-check: notes
  • Minutes Mirror

    silverstein/minutes

    Self-coaching analysis of your own behavior across meetings — talk-time ratio, filler words, hedging language, monologue length, energy patterns, and (when meetings are tagged via /minutes-tag) what…

    1.5k GitHub stars~3.5k tokensUpdated yesterday
    Auto-check passed
  • Minutes Tag

    silverstein/minutes

    Lightweight outcome tagging for meetings — won, lost, stalled, great, or noise.

    1.5k GitHub stars~2.2k tokensUpdated yesterday
    Auto-check passed
  • Minutes Record

    silverstein/minutes

    Start or stop recording a meeting, call, or voice memo. An agent skill from silverstein/minutes.

    1.5k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Minutes Brief

    silverstein/minutes

    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.

    1.5k GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed
  • Minutes Cleanup

    silverstein/minutes

    Manage old recordings — find large files, archive old meetings, delete processed originals.

    1.5k GitHub stars~852 tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Minutes Verify

What does Minutes Verify do?

Verify that Minutes is properly set up and working — model downloaded, mic accessible, directories exist, no stale state. Minutes Verify is an agent skill from silverstein/minutes. Verify that Minutes is properly set up and working — model downloaded, mic accessible, directories exist, no stale state.

When should I use Minutes Verify?

Minutes Verify fits situations like: the user says is minutes working; test recording setup; why isnt minutes working; minutes health check.

How do I install Minutes Verify in Claude Code?

Run `npx skills add silverstein/minutes --skill minutes-verify -a claude-code`. Or copy the skill folder (.opencode/skills/minutes-verify in silverstein/minutes) into .claude/skills/minutes-verify in your project. Claude Code loads it when a task matches its description.

How do I install Minutes Verify in Codex?

Run `npx skills add silverstein/minutes --skill minutes-verify -a codex`. Or copy the skill folder (.opencode/skills/minutes-verify in silverstein/minutes) into .agents/skills/minutes-verify in your project. Codex loads it when a task matches its description.

Can I use Minutes Verify in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add silverstein/minutes --skill minutes-verify -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/minutes-verify, .gemini/skills/minutes-verify, .github/skills/minutes-verify and .opencode/skills/minutes-verify in your project.

What does Minutes Verify need to run?

Going by SKILL.md and its folder, Minutes Verify needs a shell for the scripts in its folder and the command-line tools its instructions call (git, bash and cargo). Our summary lists: A Bash shell. Compatibility (from SKILL.md): opencode.

Does Minutes Verify access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Minutes Verify safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Minutes Verify use?

Minutes Verify is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Minutes Verify use?

About 801 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Minutes Verify?

Skills that share tags, products or a category with Minutes Verify: Site Architecture (AvdLee/RocketSimApp, 804 stars), Engine Whats New (flutter/flutter, 179k stars), macOS Spm App Packaging (Dimillian/Skills, 4k stars) and Openclaw Live Updater (openclaw/openclaw, 392k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Minutes Verify?

silverstein (a GitHub user) maintains it in silverstein/minutes, which has 1,541 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 8, 2026.

Source: silverstein/minutes on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.