minutes-cleanup
Manage old recordings — find large files, archive old meetings, delete processed originals
Install / Use
npx skills add silverstein/minutes --skill minutes-cleanupInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Content & MediaSupported Platforms
Tags
Our assessment of minutes-cleanup
minutes-cleanup scores 86/100 on our quality scale, 723rd of 1,155 Content & Media skills we index.
Its SKILL.md is 3.3 KB long, well organised into 17 sections with 6 code examples: a solid amount of guidance for an agent.
With 1,500 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so minutes-cleanup is actively maintained.
- Our last check on 2026-11-03 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-10-01. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
minutes-cleanup compared with similar skills
All 4 of these similar skills score higher than minutes-cleanup; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| minutes-cleanup (this skill)by silverstein | 86 | 1.5k | 54d ago | SKILL.md |
| siyuanby siyuan-note | 100 | 47.3k | today | MCP Server |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
Frequently asked questions
- How do I install minutes-cleanup?
- Run
npx skills add silverstein/minutes --skill minutes-cleanup. The install tabs above show the steps for each supported agent. - Which AI agents does minutes-cleanup work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is minutes-cleanup safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is minutes-cleanup still maintained?
- The repository was last updated about 2 months ago, so minutes-cleanup is actively maintained.
Skill content
View source on GitHubname: 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
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.
Related Skills
siyuan
47.3kAn open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
