Minutes Cleanup Agent Skill
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.
Install
one command, takes just this skill from the repositorynpx skills add https://github.com/silverstein/minutes --skill minutes-cleanupThe instruction itself
9 sections, as written by the author/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
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.
# 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.
minutes cleanup --apply
minutes cleanup --older-than 14d --apply
Archive old meetings
Move meetings older than N days to an archive folder:
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:
du -sh ~/meetings/memos/processed/ 2>/dev/null
Clean up stale state
# 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
.mdfiles without asking — These are the transcripts. They're small and contain the actual value. WAV files are the space hogs. - Prefer
minutes cleanupover rawfind -delete— The CLI understands pinned audio and sidecar stems. - Archived meetings are invisible to search —
minutes searchonly 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: pinnedto 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.
Other skills for the same job
different authors, same section of the catalogue
Analyzes meeting transcripts and recordings to uncover behavioral patterns, communication insights, and actionable feedback. Identifies when you avoid conflict, use filler words, dominate conversations, or miss opportunities to listen. Perfect for professionals seeking to improve their communication and leadership skills.
Toolkit for creating animated GIFs optimized for Slack, with validators for size constraints and composable animation primitives. This skill applies when users request animated GIFs or emoji animations for Slack from descriptions like "make me a GIF for Slack of X doing Y".
Analyzes your recent Claude Code chat history to identify coding patterns, development gaps, and areas for improvement, curates relevant learning resources from HackerNews, and automatically sends a personalized growth report to your Slack DMs.
Knowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack.
A skill that creates new Claude skills and automatically shares them on Slack using Rube for seamless team collaboration and skill discovery.
Automate Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify, etc.) using agent-browser via Chrome DevTools Protocol. Use when the user needs to interact with an Electron app, automate a desktop app, connect to a running app, control a native app, or test an Electron application. Triggers include "automate Slack app", "control VS Code", "interact with Discord app", "test this Electron app", "connect to desktop app", or any task requiring automation of a native Electron application.
Prepare meeting materials with Notion context and Codex research; use when gathering context, drafting agendas/pre-reads, and tailoring materials to attendees.
Interactive daily standup/meeting update generator. Use when user says 'daily', 'standup', 'scrum update', 'status update', 'what did I do yesterday', 'prepare for meeting', 'morning update', or 'team sync'. Pulls activity from GitHub, Jira, and Claude Code session history. Conducts 4-question interview (yesterday, today, blockers, discussion topics) and generates formatted Markdown update.
How to use it
Take silverstein/minutes-.opencode-minutes-cleanup from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.