Agent skill

Minutes Cleanup

by silverstein in silverstein/minutes

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

MITAuto-check passedMedia & Creative

Install Minutes Cleanup

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

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

GitHub CLI
$ gh skill install silverstein/minutes minutes-cleanup --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-cleanup .claude/skills/minutes-cleanup && 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-cleanup
GitHub stars
1.5k
Token cost
~852 tokens
SKILL.md length
303 words
Files
1
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

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

  • The user says clean up recordings
  • SKILL.md covers Check current usage, Common cleanup tasks and Gotchas
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • How much space are meetings using

What it does

Minutes Cleanup is an agent skill from silverstein/minutes. Manage old recordings — find large files, archive old meetings, delete processed originals. Use when the user says "clean up recordings", "how much space are meetings using", "delete old recordings", "archive meetings", "manage meeting storage", or asks about disk space from minutes.

Its SKILL.md is about 850 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: opencode

It sits in Media & Creative, covering Transcription. 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 clean up recordings
  • How much space are meetings using
  • Delete old recordings
  • Archive meetings

Example prompts

  • “clean up recordings”
  • “how much space are meetings using”
  • “delete old recordings”
  • “/minutes-cleanup”

Requirements

  • 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

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

  • Network

    No URLs in SKILL.md.

    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 Cleanup loads about 852 tokens when it runs. Until then it costs about 75 tokens; SKILL.md has 303 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

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

Download SKILL.mdSave it as .claude/skills/minutes-cleanup/SKILL.md (or your agent's skills folder).
name
minutes-cleanup
description
Manage old recordings — find large files, archive old meetings, delete processed originals. Use when the user says "clean up recordings", "how much space are meetings using", "delete old recordings", "archive meetings", "manage meeting storage", or asks about disk space from minutes.
compatibility
opencode

/minutes-cleanup

Help the user manage disk space and organize old recordings. Minutes is transcript-first: markdown notes and structured memory are durable, while raw audio is a temporary recovery/reprocessing layer unless pinned.

Check current usage

bash
minutes storage
minutes storage --json

Present this to the user before taking any action.

Common cleanup tasks

Preview raw-audio cleanup

After transcription, the original audio files are no longer needed for search or recap. They only matter if you want to re-transcribe with a better model or debug recovery. Cleanup is preview-only unless --apply is passed.

bash
# Use the configured retention policy
minutes cleanup

# Try a shorter successful-audio window
minutes cleanup --older-than 14d

# Machine-readable preview for agents
minutes cleanup --json
Delete raw audio candidates

Only apply cleanup after showing the preview and getting explicit confirmation.

bash
minutes cleanup --apply
minutes cleanup --older-than 14d --apply
Archive old meetings

Move meetings older than N days to an archive folder:

bash
mkdir -p ~/meetings/archive

# Find meetings older than 90 days
find ~/meetings -maxdepth 1 -name "*.md" -mtime +90

# Move them (confirm with user first)
find ~/meetings -maxdepth 1 -name "*.md" -mtime +90 -exec mv {} ~/meetings/archive/ \;

Archived meetings won't appear in minutes list or minutes search (which only scans ~/meetings/), but they're still on disk if needed.

Clean up processed voice memos

The watcher moves originals to ~/meetings/memos/processed/ after transcription:

bash
du -sh ~/meetings/memos/processed/ 2>/dev/null
Clean up stale state
bash
# Remove stale PID file
rm -f ~/.minutes/recording.pid

# Clean old logs (keep last 7 days)
find ~/.minutes/logs -name "*.log" -mtime +7 -delete 2>/dev/null

# Remove last-result.json (transient)
rm -f ~/.minutes/last-result.json

Gotchas

  • Never delete .md files without asking — These are the transcripts. They're small and contain the actual value. WAV files are the space hogs.
  • Prefer minutes cleanup over raw find -delete — The CLI understands pinned audio and sidecar stems.
  • Archived meetings are invisible to search — minutes search only walks ~/meetings/ and ~/meetings/memos/. If you need archived meetings searchable, configure QMD to index ~/meetings/archive/ too.
  • Audio deletion is irreversible — If the user might want to re-transcribe with a better model later, suggest pinning important recordings and only deleting old unpinned candidates.
  • Pin exceptions in frontmatter — Add audio_retention: pinned to a meeting to keep its raw audio out of cleanup candidates.
  • Audio is ~10 MB/minute, transcripts are ~1 KB/minute — Deleting audio saves 99%+ of space while keeping all searchable content.
  • iCloud sync caveat — If ~/meetings/ is in an iCloud-synced folder, deleted files go to "Recently Deleted" and still count against storage for 30 days.

© 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

Just SKILL.md in .opencode/skills/minutes-cleanup of silverstein/minutes.

Open the folder on GitHubat commit d3285c7

Compare with similar skills

Minutes Cleanup 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 Cleanup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Minutes Cleanup this skillsilverstein/minutes1.5k—~852Automated safety check: PassMIT
HyperFrames Media Useheygen-com/hyperframes60k—~2.4kAutomated safety check: PassApache-2.0
Native Subtitle Quote Imagechengyi-ai/native-subtitle-quote-image2.6k—~1.8kAutomated safety check: PassMIT
Edu Chem Videowy51ai/edulab1.4k—~2.1kAutomated safety check: NotesApache-2.0
Transcription Memory ReconstructionNxcoreAI/EverRoom3k—~714Automated safety check: PassCustom licence
Edu Math Videowy51ai/edulab1.4k—~2.5kAutomated safety check: NotesApache-2.0

Similar skills

  • HyperFrames Media Use

    heygen-com/hyperframes

    Finds, generates and edits media for HyperFrames video projects: music, sound effects, images, icons, logos, voiceovers, captions and color grades.

    60k GitHub stars~2.4k tokensUpdated today
    Media & CreativeAuto-check passed
  • Native Subtitle Quote Image

    chengyi-ai/native-subtitle-quote-image

    将本地视频或用户有权处理的在线视频,经过来源获取、文字稿定位、选题选句、精确取帧、紧凑裁切、拼图和逐张质检,制作成 3:4 或保留画面原比例的视频字幕长图。支持两种明确分开的输出:保留画面内已烧录字幕的原生字幕模式,以及把已审核的时间点与台词绘制到真实视频帧上的脚本字幕模式。用户要求原生字幕截图、字幕帧拼图、YouTube…

    2.6k GitHub stars~1.8k tokensUpdated today
    Media & CreativeAuto-check passed
  • Edu Chem Video

    wy51ai/edulab

    A skill your agent uses when asked to make an explainer / walkthrough video (讲解视频、解题视频、例题精讲、微课) for a chemistry problem (化学题: 氧化还原配平 双线桥 电子守恒, 物质的量计算, 化学平衡 三段式 平衡常数 转化率 反应速率, 离子反应, 电化学, 溶液 滴定…

    1.4k GitHub stars~2.1k tokensUpdated today
    Media & CreativeAuto-check: notes
  • Reconstruct a complete, searchable memory from an untrusted meeting or conversation transcript.

    3k GitHub stars~714 tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Edu Math Video

    wy51ai/edulab

    A skill your agent uses when asked to make an explainer / walkthrough video (讲解视频、解题视频、例题精讲、微课) for a math problem (数学题, geometry, algebra, functions, motion/行程 problems), from a problem screenshot…

    1.4k GitHub stars~2.5k tokensUpdated today
    Media & CreativeAuto-check: notes
  • Transcribe

    JetBrains/skills

    Official

    Transcribe audio files to text with optional diarization and known-speaker hints.

    366 GitHub starsUsed in 4 repos~776 tokens
    Media & CreativeAuto-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 Verify

    silverstein/minutes

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

    1.5k GitHub stars~801 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

Questions about Minutes Cleanup

What does Minutes Cleanup do?

Manage old recordings — find large files, archive old meetings, delete processed originals. Minutes Cleanup is an agent skill from silverstein/minutes. Manage old recordings — find large files, archive old meetings, delete processed originals.

When should I use Minutes Cleanup?

Minutes Cleanup fits situations like: the user says clean up recordings; how much space are meetings using; delete old recordings; archive meetings.

How do I install Minutes Cleanup in Claude Code?

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

How do I install Minutes Cleanup in Codex?

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

Can I use Minutes Cleanup 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-cleanup -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-cleanup, .gemini/skills/minutes-cleanup, .github/skills/minutes-cleanup and .opencode/skills/minutes-cleanup in your project.

What does Minutes Cleanup need to run?

SKILL.md names no scripts, command-line tools or credentials: Minutes Cleanup is instructions for the agent only. Compatibility (from SKILL.md): opencode.

Does Minutes Cleanup access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Minutes Cleanup 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. Review the folder before installing.

What licence does Minutes Cleanup use?

Minutes Cleanup 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 Cleanup use?

About 852 tokens (SKILL.md is roughly 3.4k 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 Cleanup?

Skills that share tags, products or a category with Minutes Cleanup: HyperFrames Media Use (heygen-com/hyperframes, 60k stars), Native Subtitle Quote Image (chengyi-ai/native-subtitle-quote-image, 2.6k stars), Edu Chem Video (wy51ai/edulab, 1.4k stars) and Transcription Memory Reconstruction (NxcoreAI/EverRoom, 3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Minutes Cleanup?

silverstein (a GitHub user) maintains it in silverstein/minutes, which has 1,542 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.