zoom-summary
Skill4 starsChanged 20 days agoMITView on GitHub
Read Zoom AI Companion meeting summaries through the Zoom REST API, save them as markdown, repair the domain terms Zoom mistranscribes, translate them to Korean, and hand decisions off to the research log; also list and clean up (trash) Zoom cloud recordings. Use when the user asks about a past Zoom meeting, meeting summary, AI Companion notes, 회의록, 미팅 요약, 지난 미팅 내용, wants last week's Zoom meetings written up, wants meeting-summary jargon or 용어 보정 fixed, or wants to 정리/삭제 Zoom 클라우드 녹화본 (cloud recordings, storage cleanup). Credentials live at `~/.config/zoom-skill/credentials.json`.
- Reads credentials
1 other project uses a version of this.
Adopted by
Most recently taken up by
- fditraglia/castle-adamanttheir own version, first seen Nov 15, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- fditraglia/castle-adamant★ 4same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository38 other files it gives its agents.
- academic-cvSkill
- academic-jobsSkill
- academic-proseSkill
- adversarial-reviewSkill
- bibtex-genSkill
- chrome-sessionSkill
- clickup-cliSkill
- clickup-todaySkill
- commit-triageSkill
- concept-explainerSkill
- contact-emailSkill
- cover-letterSkill
- dropboxSkill
- handdrawn-schematicSkill
- hep-rumor-millSkill
- journal-club-reviewSkill
- magi-researchSkill
- md2pdf-typoraSkill
- morgenSkill
- overleaf-section-workflowSkill
- overleapSkill
- peer-agent-reviewSkill
- proton-mailSkill
- reference-searchSkill
- remarkable-syncSkill
- research-backupSkill
- research-boardSkill
- research-logSkill
- research-portalSkill
- research-proposalSkill
- research-reportSkill
- research-statementSkill
- scienceplot-pySkill
- vastaiSkill
- wide-slide-illustratorSkill
- workshop-paper-reviewSkill
- xkcd-pySkill
- zai-web-searchSkill
The file
We split this skill into the rules it gives an agent
11 rules. About 0 are common, 4 are distinctive, and 7 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
7
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 22
Before any operation, check the credentials file exists:
- Very specific: line 26
If it does not exist, run the setup flow below.
- Distinctive: line 34
Check whether credentials already exist.
- Very specific: line 44
When the user replies with the three values, run the --stdin mode so the secret stays out of argv:
- Distinctive: line 59
If neither is grantable, the zoom.us web portal (Meeting Summary with AI Companion → My Summaries) is the only remaining route.
- Distinctive: line 61
Do not auto-retry exit code 3.
- Very specific: line 65
All scripts live in this skill directory's scripts/ folder.
- Very specific: line 97
Run list over the range the user names.
- Very specific: line 100
Run delete --yes (trash). Use --permanent only when the user asks for it by name.
- Very specific: line 128
Term correction: Run correct.py --in-place on every saved summary, then work the "검토 필요" list.
- Very specific: line 136
research-log handoff: When the user asks to log the meeting, use the research-log skill's record workflow.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Zoom Summary
Access to Zoom AI Companion meeting summaries (read-only) and Zoom cloud recordings (list, trash) via the Zoom REST API v2, using a Server-to-Server OAuth app. Wraps the endpoints with curl + jq helpers, and repairs the domain terms the summariser mistranscribes.
Trigger conditions
Invoke this skill when the user says any of:
- "지난 미팅 요약 보여줘" / "what did we discuss in Monday's Zoom" / "last week's Zoom meetings" →
scripts/summaries.sh list - "그 미팅 요약 전체 내용" / "show me the full summary" →
scripts/summaries.sh get <uuid> - "요약 저장해줘" / "save that summary as markdown" →
scripts/summaries.sh save <uuid> - "용어 보정해줘" / "fix the mangled terms" / "그 약어 잘못 받아썼는데" →
scripts/correct.py - "녹화본 정리" / "클라우드 녹화 지워줘" / "Zoom cloud storage full" →
scripts/recordings.sh list, thendeleteafter confirmation (see Recording cleanup) - "set up Zoom" / "configure Zoom" / credentials file missing → follow the Setup flow below
Prerequisites
Before any operation, check the credentials file exists:
test -f ~/.config/zoom-skill/credentials.jsonIf it does not exist, run the setup flow below. For recording cleanup the credentials may instead be in ~/.config/zoom-skill/recordings-credentials.json (see recordings.sh). Dependencies: curl, jq, base64 (scripts exit 127 if missing), plus python3 for correct.py.
The account must have AI Companion meeting summaries enabled, and the summaries must already have been generated and saved. This skill cannot generate a summary for a meeting that never had AI Companion on.
Setup flow (skill-orchestrated)
The Zoom Marketplace app must be created by the user in a browser. You cannot do this step.
- Check whether credentials already exist. If they do, ask before re-registering.
- Give the user these steps verbatim:
- https://marketplace.zoom.us → Develop → Build App → Server-to-Server OAuth
- Scopes tab, add
meeting:read:list_summaries:adminandmeeting:read:summary:admin. If the picker does not offer them, add the classic scopemeeting_summary:read:admin, which covers both. For recording cleanup also addcloud_recording:read:list_user_recordings:adminandcloud_recording:delete:meeting_recording:admin. - Activate the app.
- Copy Account ID, Client ID, Client Secret from App Credentials.
These get stored at
~/.config/zoom-skill/credentials.json(mode 600). Only paste them here if you trust this terminal and session transcript. - When the user replies with the three values, run the
--stdinmode so the secret stays out of argv:bash scripts/setup.sh --stdin <<< '{"account_id":"<A>","client_id":"<I>","client_secret":"<S>"}' - Show the script's scope report verbatim. It prints
GRANTEDorMISSINGper scope plus a live probe of the list endpoint. - On failure, show stderr verbatim and ask whether to retry.
Do not echo the client secret back in your own messages. Do not run setup unprompted; the triggers are an explicit request or a script exiting 2.
Known scope gotcha
meeting:read:summary:admin (the summary body scope) is reported missing from the scope picker on some accounts. The symptom is that list works but get returns HTTP 403. If that happens:
- Tell the user which scope the API refused, quoting the error.
- Have them check for the classic
meeting_summary:read:adminscope instead. - If neither is grantable, the zoom.us web portal (Meeting Summary with AI Companion → My Summaries) is the only remaining route. Say so plainly rather than retrying.
Do not auto-retry exit code 3.
Script usage
All scripts live in this skill directory's scripts/ folder.
setup.sh — one-time credential registration
bash scripts/setup.sh # interactive (TTY required)
bash scripts/setup.sh --stdin <<< '<json>'Verifies by minting a real token, writes credentials mode 600, then reports granted scopes and probes the list endpoint. There is no flag mode: a client secret on argv is visible in /proc.
summaries.sh — the actual work
bash scripts/summaries.sh list [--from YYYY-MM-DD] [--to YYYY-MM-DD] [--json]
bash scripts/summaries.sh get <meetingUUID> [--json]
bash scripts/summaries.sh save <meetingUUID> [--dir <path>] [--force]listdefaults to the last 30 days and followsnext_page_tokento the end. Output is TSV:start_time,topic,meeting_id,uuid. Use the uuid column forgetandsave, not the meeting ID.getrenders markdown by default;--jsongives the raw body.savewrites to$ZOOM_SUMMARY_DIR(default~/Documents/ZoomSummaries) asYYYY-MM-DD_<topic-slug>.mdand prints the path. It refuses to overwrite without--force.
Meeting UUIDs often contain /, +, and =. Always quote them in shell commands. auth.sh handles Zoom's rule that a UUID starting with / or containing // must be double URL encoded; every other UUID goes through as is.
recordings.sh — cloud recording cleanup
bash scripts/recordings.sh list [--from YYYY-MM-DD] [--to YYYY-MM-DD] [--user <id|email>] [--json]
bash scripts/recordings.sh delete [--permanent] [--yes] <meetingUUID>... | -listdefaults to the last 365 days, walking 30-day windows because the endpoint rejects longer ranges. TSV:start_time,topic,size_MB,files,uuid; a meeting-count and GB total goes to stderr.--userdefaults to$ZOOM_RECORDING_USER, elseme.deleteremoves every recording file of each meeting UUID;-reads UUIDs from stdin, one per line. Defaultaction=trash(Zoom keeps trash 30 days);--permanentskips the trash. Without--yesit is a dry run.- Credentials: the recording scopes sit on a separate Server-to-Server app.
recordings.shuses~/.config/zoom-skill/recordings-credentials.json(mode 600, same JSON shape) with its own token cache~/.cache/zoom-skill/recordings/when that file exists, elsecredentials.json. Register it withZOOM_SKILL_CREDS=~/.config/zoom-skill/recordings-credentials.json bash scripts/setup.sh --stdin; setup's summary-scope report will say MISSING for this app, which is expected.
Recording cleanup
- Run
listover the range the user names; show the TSV and the total. - Agree the deletion rule with the user (date cutoff, topic, size). Build the UUID set from the
--jsonoutput, not by retyping UUIDs. - Show the exact rows to be deleted and get explicit confirmation; deletion is a consequential action.
- Run
delete --yes(trash). Use--permanentonly when the user asks for it by name. - Re-run
liston the same range and report the before/after count and GB.
correct.py — repair mangled domain terms
python3 scripts/correct.py <file.md|-> [--in-place] [--report-only] [--no-appendix] [--glossary PATH]Zoom's summariser mishears domain jargon consistently: acronyms come back as similar-sounding words, journal names get truncated, personal names get reversed. This applies the glossary and appends an audit table.
Two tiers, and the distinction is the whole point:
high— substituted automatically.low— never substituted, only listed under "검토 필요" for a human to resolve. Terms whose correct form is unknown live here with?as the replacement.
--in-place keeps the untouched summary as <stem>.raw.md. Re-running re-derives from that raw file, so the run is idempotent, the substitution record survives, and glossary edits always apply to pristine text.
--report-only prints the report to stderr and writes nothing. --no-appendix corrects the text without appending the audit table. Reading from - (stdin) writes to stdout and cannot be combined with --in-place.
Glossaries load in order, later overriding earlier by pattern:
references/glossary.tsvin this skill — template only, ships with no real terms~/.config/zoom-skill/glossary.tsv— where every real entry belongs (override the path withZOOM_SKILL_GLOSSARY)- anything passed with
--glossary(repeatable)
Requires python3. Exits 1 when the file is missing or no glossary entry exists anywhere, and 64 when --in-place is given with stdin.
After fetching
Term correction. Run
correct.py --in-placeon every saved summary, then work the "검토 필요" list.Resolve unknowns against the research log before asking the user. For a project registered in
~/.research/,projects/<slug>/compass.mdcarries the canonical vocabulary and paper structure, andjournal.mdcarries verbatim usage. A term earns thehightier when you can cite the line that settles it: a garbled acronym in a sentence about a specific paper section resolves once compass.md says what that paper is about. Put the citation in the note column.Two limits worth knowing before you start digging. The research log holds no personal names at all, so mangled names never resolve there and must go to the user. And the log lags the meeting: it is a decision record, not a transcript, so a term coined in the meeting itself will not be in it.
Everything you cannot cite stays
low. Propose it to the user with your evidence and let them confirm; do not promote on plausibility alone. All real entries go in~/.config/zoom-skill/glossary.tsv. The skill'sreferences/glossary.tsvis a template only: it is version controlled and may be pushed to a public remote, so project vocabulary and personal names must never be written there.- Korean translation. Produce
<basename>_ko.mdin the same directory. Skip it when the summary is already Korean, which it usually is when the meeting was. Per the user's global convention, delegate the translation to a Sonnet subagent, preserving the heading structure and any English proper nouns inside Korean sentences. - research-log handoff. When the user asks to log the meeting, use the
research-logskill's record workflow. Pass only the decisions and action items, not the full summary text; a journal entry is not a transcript dump. - Reporting. Never paraphrase a summary as if it were the API's own words when you have not fetched it. If
listreturned rows butgetfailed, say which step failed. When you relay meeting content to the user, say plainly that AI Companion garbles proper nouns and that only glossary-backed terms have been repaired.
Error handling
Show script stderr to the user verbatim. Exit code reference:
- 0 — success
- 1 — bad argument,
saverefused to overwrite, orcorrect.pyfound no file / no glossary entry - 2 — credentials.json missing (→ run setup.sh)
- 3 — token rejected or scope missing, HTTP 401/403, or HTTP 400 code 4711 (→ see the scope gotcha above; after adding scopes delete
~/.cache/zoom-skill/token.json, since a cached token keeps the old scopes for up to an hour) - 4 — meeting UUID not found, HTTP 404 (often a UUID that needed quoting)
- 5 — other API error
- 6 — rate limited, HTTP 429
- 64 — usage error
- 127 — missing dependency
Environment overrides
ZOOM_SKILL_CREDS— credentials path (default~/.config/zoom-skill/credentials.json)ZOOM_SKILL_CACHE— token cache directory (default~/.cache/zoom-skill)ZOOM_SUMMARY_DIR— markdown output directory (default~/Documents/ZoomSummaries)ZOOM_SKILL_GLOSSARY— user glossary path (default~/.config/zoom-skill/glossary.tsv)ZOOM_RECORDING_USER— user ID or email forrecordings.sh list(defaultme)ZOOM_RECORDING_CREDS— credentials forrecordings.sh(default~/.config/zoom-skill/recordings-credentials.json; ignored ifZOOM_SKILL_CREDSis set)ZOOM_API_BASE,ZOOM_OAUTH_URL— API and token endpoints. Only for pointing the scripts at a stand-in server during testing; never change them in normal use.
API notes
Base https://api.zoom.us/v2. Tokens come from POST https://zoom.us/oauth/token with grant_type=account_credentials, live one hour, and are cached in ~/.cache/zoom-skill/token.json keyed by a fingerprint of the credentials.
| Purpose | Endpoint |
| List summaries | GET /meetings/meeting_summaries?from&to&page_size&next_page_token |
| Summary body | GET /meetings/{meetingUUID}/meeting_summary |
| List recordings | GET /users/{userId}/recordings?from&to&page_size&next_page_token&trash (≤1 month per call) |
| Delete recordings | DELETE /meetings/{meetingUUID}/recordings?action=trash|delete |
Body fields: summary_title, summary_overview, summary_details[].{label,summary}, next_steps[], summary_start_time, summary_end_time, summary_created_time, meeting_host_email.
Upstream docs: https://developers.zoom.us/docs/api/meetings/
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

