Agent skill

Scribe Meeting Notes

by ooiyeefei in ooiyeefei/ccc

Turns meeting recordings into notes with a chain of custody from audio to claim, auditing transcripts for gaps and low-confidence numbers and names.

MITAuto-check passedProductivity & Automation

Install Scribe Meeting Notes

skills CLI
$ npx skills add ooiyeefei/ccc --skill scribe -a claude-code

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

GitHub CLI
$ gh skill install ooiyeefei/ccc scribe --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/ooiyeefei/ccc.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/scribe .claude/skills/scribe && 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
scribe
GitHub stars
494
Token cost
~876 tokens
SKILL.md length
474 words
Files
6 (incl. scripts, references)
Skills in repo
22
Repo updated
First seen
Licence
MIT

At a glance

Turns meeting recordings into notes with a chain of custody from audio to claim, auditing transcripts for gaps and low-confidence numbers and names.

  • Works in 5 steps: Establish the recording's context → Transcribe → Audit before you read → …
  • Turning meeting recordings into trustworthy notes
  • SKILL.md covers 1. Establish the recording's…, 2. Transcribe, 3. Audit before you read and 4. Corroborate against any…, plus 1 more section
  • Runs Python scripts from its folder; calls python

What it does

The skill rests on the idea that a summarizer cannot hear and will turn garbled audio into confident, clean-sounding facts. It keeps a chain of custody so every claim in the notes traces to audio the model heard well, and a claim with broken custody says so. It begins by pinning down the recording's language, speakers and domain vocabulary, then transcribes with scripts/transcribe.py, preferring a backend that labels speakers.

Next, scripts/audit.py reports two kinds of findings: gaps, where a recorder dropped content, and risky spans, where numbers and proper nouns rest on low-confidence audio. Each finding must be corroborated against a second transcript, confirmed with you or carried into the notes as a marked uncertainty, and a transcript from another tool can be aligned against the first. The scripts need Python with httpx, the local provider also needs faster-whisper, and a providers reference covers setup and cost.

When your agent uses it

  • Turning meeting recordings into trustworthy notes
  • Fixing garbled or untrustworthy auto-generated transcripts or summaries
  • Transcribing audio with speaker labels and domain terms
  • Checking a transcript for gaps and unreliable figures

Example prompts

  • “Transcribe ./recordings/weekly-sync.m4a with speaker labels and write the meeting notes.”
  • “The auto-summary of our call looks wrong, so audit the transcript for risky numbers.”
  • “Compare my transcript with the one from the other tool and flag the differences.”

Requirements

  • Python with httpx
  • faster-whisper, for the local provider
  • An API key for a hosted transcription provider, unless the local provider is used

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Establish the recording's context
  2. Transcribe
  3. Audit before you read
  4. Corroborate against any second transcript
  5. Write the notes

What it can do on your machine

Read from SKILL.md and the folder at commit c0fd926. 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 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    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.

Context cost

Scribe Meeting Notes loads about 876 tokens when it runs, and up to ~2.3k if it reads all its reference files. Until then it costs about 62 tokens; SKILL.md has 474 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~62
When it runs · the whole SKILL.md, loaded when a task matches
~876
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.3k

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 ooiyeefei/ccc at commit c0fd926, republished under its MIT licence (© ooiyeefei). 474 words, ~876 tokens.

Download SKILL.mdSave it as .claude/skills/scribe/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
scribe
description
Turn meeting recordings into notes with an unbroken chain of custody from audio to claim. Use when the user has recordings or audio to transcribe or summarize, or when an existing transcript or auto-summary reads as garbled or untrustworthy.

A summariser cannot hear. Hand it a garbled span and it launders the noise into a clean fact — "some paying customer" becomes "~8,000 users" — and nothing downstream can separate that from a real figure. This skill holds a chain of custody: every claim in the notes traces back to audio the model actually heard well, and a claim whose custody is broken says so.

Scripts are in scripts/. They need a Python with httpx; --provider local also needs faster-whisper.

1. Establish the recording's context

Ask the user, or read it off the surrounding material — the files, the repo, an existing transcript:

  • Language — the ISO code to pin. Left unpinned, per-window detection flaps on code-switched speech and the decoder emits fluent, confident text in the wrong language.
  • Speakers — how many, plus names and roles.
  • Domain vocabulary — product names, people, companies, jargon, currencies.

Done when you can state the language code, the speaker count, and at least five domain terms.

2. Transcribe

python scripts/transcribe.py AUDIO... --out DIR --language <code> --diarize --keyterms "term,term,..."

--provider selects the backend; auto takes the first with a key present. Setup, capability and cost per provider: references/providers.md.

Prefer a backend that diarizes. Speaker labels you derive yourself by reasoning about who-said-what are inference, and inference is a break in the chain of custody.

Done when every input file has a .json and .txt in DIR.

3. Audit before you read

python scripts/audit.py DIR

Two findings, both of which vanish once a transcript is flattened into prose:

  • Gaps — a recorder stopped mid-meeting drops content in silence, and the notes that follow read as complete. A gap is a stretch of the meeting you hold no evidence for.
  • Risky spans — numbers and proper nouns resting on low-confidence audio. This is where laundering happens.

Give every finding one of three dispositions: corroborated against a second transcript, confirmed with the user, or carried into the notes as a marked uncertainty.

Done when the count of dispositions equals the count of findings.

Show full SKILL.md (158 more words)Show less

4. Corroborate against any second transcript

When the user has another transcript of the same audio — Granola, Otter, an earlier run — align it against yours.

Two independent decodes are the cheapest confidence signal available. A claim present in one and absent from the other is a divergence, not a fact, and inherits the lower confidence of the two. Where your audio has gaps, the other transcript may be the only evidence that exists; anything sourced that way stays marked as uncorroborated.

5. Write the notes

Group by topic, so each section stands on its own.

Every figure and every named entity carries its custody:

Traced toWritten as
a span above thresholdstated plainly
a flagged spanstated with its marking and timestamp
a gap-filling second transcript onlymarked uncorroborated
no sourceabsent

Cite timestamps for anything a reader might challenge.

Done when every figure and named entity in the notes falls into one of those four rows.

© ooiyeefei, 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 5 other files (scripts, references) in skills/scribe of ooiyeefei/ccc.

  • SKILL.md
  • README.md
  • references/providers.md
  • scripts/_thresholds.py
  • scripts/audit.py
  • scripts/transcribe.py

Open the folder on GitHubat commit c0fd926

Compare with similar skills

Scribe Meeting Notes 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.

Scribe Meeting Notes compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Scribe Meeting Notes this skillooiyeefei/ccc494—~876Automated safety check: PassMIT
Whisper Speech RecognitionOrchestra-Research/AI-Research-SKILLs13k8 repos~1.9kAutomated safety check: NotesMIT
Video To Subtitle Summaryimlewc/video-to-subtitle-summary-skill212—~4.6kAutomated safety check: NotesMIT
Issue From NotesAxonIQ/AxonFramework3.6k—~1.1kAutomated safety check: PassApache-2.0
AgentCall Join Meetingpattern-ai-labs/agentcall1651 repos~25kAutomated safety check: PassMIT
Transcript Fixerdaymade/claude-code-skills1.4k—~10kAutomated safety check: PassMIT

Similar skills

  • Whisper Speech Recognition

    Orchestra-Research/AI-Research-SKILLs

    Transcribes audio with OpenAI's Whisper: 99 languages, translation to English, language detection, six model sizes and word-level timestamps, from Python or the CLI.

    13k GitHub starsUsed in 8 repos~1.9k tokens
    AI & LLM EngineeringAuto-check: notes
  • Video To Subtitle Summary

    imlewc/video-to-subtitle-summary-skill

    A skill your agent uses when user provides a short video platform URL or local video/audio file and wants subtitles/AI summary, or when user asks to list their own AI Douyin historical tasks.

    212 GitHub stars~4.6k tokensUpdated 2 mo ago
    Media & CreativeAuto-check: notes
  • Issue From Notes

    AxonIQ/AxonFramework

    Create well-structured GitHub issues from any source: meeting notes, transcriptions, conversation context, informal descriptions, or direct requests.

    3.6k GitHub stars~1.1k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • AgentCall Join Meeting

    pattern-ai-labs/agentcall

    Joins Google Meet, Teams or Zoom video calls as an AI bot with voice and visual presence through the AgentCall service, in audio, text-to-speech or webpage modes.

    165 GitHub starsUsed in 1 repo~25k tokens
    Productivity & AutomationAuto-check passed
  • Transcript Fixer

    daymade/claude-code-skills

    Corrects ASR/STT transcription errors — homophones, garbled terms, person-name errors, mixed Chinese/English — with dictionary rules plus Claude's built-in AI, no external API key required.

    1.4k GitHub stars~10k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Vexa Meetings

    Vexa-ai/vexa

    Sends a Vexa bot into a meeting, follows the live transcript and writes meeting notes with speakers, decisions and action items into Obsidian, Notion or Markdown.

    2.9k GitHub stars~631 tokensUpdated today
    Productivity & AutomationAuto-check passed

More from ooiyeefei/ccc

All 22 skills in this repo
  • Builds marketing and explainer videos in Remotion from rendered scenes, with one real product capture as proof, and cuts them for each platform's formats.

    494 GitHub stars~2.9k tokensUpdated 2 mo ago
    Auto-check passed
  • Records a sharp product demo video by driving the real app with a browser agent, from storyboard to Xvfb capture and a narration script synced to the frames.

    494 GitHub stars~2.8k tokensUpdated 2 mo ago
    Auto-check passed
  • Generates architecture diagrams as .excalidraw files by analyzing a codebase, with optional PNG or SVG export through Playwright.

    494 GitHub stars~2k tokensUpdated 2 mo ago
    Auto-check passed
  • Sets up GA4 on a website and wires one real conversion event end to end, verified in DebugView before any money goes into ads.

    494 GitHub stars~2.2k tokensUpdated 2 mo ago
    Auto-check passed
  • Builds or rewrites SaaS landing pages by researching the real product, positioning it against alternatives and writing buyer-focused copy, then implementing it in the codebase.

    494 GitHub stars~1.8k tokensUpdated 2 mo ago
    Auto-check passed
  • Meta Pixel Setup

    ooiyeefei/ccc

    Walks a site owner through installing the Meta Pixel, firing one conversion event and verifying it with the Pixel Helper before any ads run.

    494 GitHub stars~2.4k tokensUpdated 2 mo ago
    Auto-check passed

Works with

Questions about Scribe Meeting Notes

What does Scribe Meeting Notes do?

Turns meeting recordings into notes with a chain of custody from audio to claim, auditing transcripts for gaps and low-confidence numbers and names. The skill rests on the idea that a summarizer cannot hear and will turn garbled audio into confident, clean-sounding facts. It keeps a chain of custody so every claim in the notes traces to audio the model heard well, and a claim with broken custody says so.

When should I use Scribe Meeting Notes?

Scribe Meeting Notes fits situations like: turning meeting recordings into trustworthy notes; fixing garbled or untrustworthy auto-generated transcripts or summaries; transcribing audio with speaker labels and domain terms; checking a transcript for gaps and unreliable figures.

How do I install Scribe Meeting Notes in Claude Code?

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

How do I install Scribe Meeting Notes in Codex?

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

Can I use Scribe Meeting Notes 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 ooiyeefei/ccc --skill scribe -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/scribe, .gemini/skills/scribe, .github/skills/scribe and .opencode/skills/scribe in your project.

What does Scribe Meeting Notes need to run?

Going by SKILL.md and its folder, Scribe Meeting Notes needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python with httpx; faster-whisper, for the local provider; An API key for a hosted transcription provider, unless the local provider is used.

Does Scribe Meeting Notes 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 Scribe Meeting Notes 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 Scribe Meeting Notes use?

Scribe Meeting Notes 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 Scribe Meeting Notes use?

About 876 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.4k tokens, read only when the agent opens those files.

What are the alternatives to Scribe Meeting Notes?

Skills that share tags, products or a category with Scribe Meeting Notes: Whisper Speech Recognition (Orchestra-Research/AI-Research-SKILLs, 13k stars), Video To Subtitle Summary (imlewc/video-to-subtitle-summary-skill, 212 stars), Issue From Notes (AxonIQ/AxonFramework, 3.6k stars) and AgentCall Join Meeting (pattern-ai-labs/agentcall, 165 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Scribe Meeting Notes?

ooiyeefei (a GitHub user) maintains it in ooiyeefei/ccc, which has 494 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on July 29, 2026.

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