
grand-rounds
Grand Rounds: evidence-first medical presentations for Claude Code, Codex & Antigravity. Grills you first, plans with your approval, traces every number to a…
Install with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
Install and set up grand-rounds (git-clone project) into my current project. Found on https://claudeers.com/grand-rounds Repo: https://github.com/drtranquanghung91-vn/grand-rounds Homepage/docs: — Detected install method: git-clone → git clone https://github.com/drtranquanghung91-vn/grand-rounds Category: skills. Platforms: api, web, mobile. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: unknown; community-verified: false. Confirm the source before running anything.
git clone https://github.com/drtranquanghung91-vn/grand-rounds
// compatibility
| Platforms | api, web, mobile |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | MIT |
| Pricing | open-source |
| Language | Python |
Grand Rounds: A Multi-Agent Harness for
Evidence-First Medical Presentations
Evidence-first medical presentations, built by your coding agent.
A skills harness for Claude Code, Codex and Antigravity that interviews you, plans the talk,
checks every number against its source, and catches the tells of machine-made slides.
Motion inside the slide instead of a pasted video: a mechanism built from Bioicons cells and antibody (left) and a sequence of Servier Medical Art drawings played as a loop (right).
Why this exists
Ask a general-purpose agent for "a journal club deck on trial X" and you usually get a file within minutes. It is also usually wrong in ways that matter in front of a medical audience:
- It decides for you. PowerPoint or HTML, which template, who the audience is, report or critique. Testing showed a baseline agent listing these as "assumptions" after committing to them.
- Numbers drift. A hazard ratio from one endpoint lands under another. "Overall survival improved" appears for HR 0.77 with P = 0.33.
- References are recalled, not retrieved. A PMID "from memory, please verify" ends up in the footer.
- The slides look machine-made: numbered eyebrow labels, KPI-card grids, presenter cues printed on the slide ("▸ click for next"), notes about how a figure was made ("original figure, recoloured").
Grand Rounds turns slide-making into a method with gates, in the spirit of Superpowers, and starts with a structured interview inspired by Matt Pocock's grilling skill.
How it works
The orchestrator skill (medical-deck) runs the stages. Stages 4–7 go to fresh
subagents with written role briefs: evidence researcher, figure maker, deck builder,
slop reviewer and evidence reviewer. Each works from files, not from the conversation, and
hands back a short structured report. Two gates stop for you: the brief and the
plan. Nothing is built before you approve the plan.
Every stage leaves a file in the talk folder, so a later session can resume and you can see what was decided:
my-talk/
├── STATUS.md stage tracker
├── brief.md what you decided in the interview
├── plan.md assertion titles, visuals, claims needed, timing
├── theme/ measured template: theme.json, scan.json, renders
├── sources/ your PDFs, guidelines, (de-identified) case notes
├── evidence/ references.json + claims.json (value, source, locator, verbatim quote)
├── figures/ SVG/PNG + manifest.json (provenance and licence)
├── build/ source, render screenshots, rendered DOM
├── out/ the deliverable (.html or .pptx)
└── audit/ slop-report.md, evidence-report.md
The skills
| Skill | Invoked by | What it is for |
|---|---|---|
medical-deck | model or you | Orchestrator: stages, gates, subagent dispatch, fix loop |
deck-grilling | model | Interview in rounds of numbered questions, each with a recommended answer. Facts are looked up; decisions are asked. Output format and template are always asked. |
deck-planning | model | Storyline recipes (journal club, conference, lecture, guideline update, clinical case, M&M), assertion titles, visual grammar, time budget |
evidence-research | model | PubMed (MCP or bundled pubmed.py), Europe PMC full text, ClinicalTrials.gov; a claim ledger with locators and verbatim quotes |
medical-figures | model | Lift Kaplan–Meier curves and forest plots as vectors from the PDF and recolour them; rebuild CONSORT, PRISMA, trial schemas and timelines; Servier Medical Art at full resolution or AI-generated illustrations (ChatGPT, Gemini) with editable labels; looping motion graphics for mechanisms and physiology |
template-matching | model | Measure a hospital or congress .pptx (colours, fonts, layouts, title boxes, backgrounds) and reproduce it |
html-deck-building | model | One offline HTML file: 1920 × 1080 stage, fragments, speaker notes, smooth GPU-only motion, laser pointer, circle and pen tools |
pptx-deck-building | model | Editable PowerPoint inside your template: native shapes for diagrams, native charts, notes |
slop-audit | model | A catalog of 21 machine-made tells (S01–S21) and a linter for the mechanical ones |
evidence-audit | model | Every number on every slide traced to a claim; PMIDs/DOIs verified against PubMed/Crossref; overclaim checks; patient-identifier scan |
/grill-deck | you | Just the interview, to sharpen a talk idea |
/audit-deck | you | Audit a deck you already have, HTML or PPTX |
What makes it different
- Claims before slides. Each number on a slide is a record in
claims.jsonwith its source, page/table/figure locator, a verbatim quote and a verification level (full text, abstract only, unverified).check_claims.pyflags any number on a slide that no claim covers. - Original figures, not redraws.
pdf_figures.pycuts a Kaplan–Meier panel out of a journal PDF as vector line art, recolours the arms to the deck's palette and separates the curves into their own layer. Every step, censor tick and number at risk is preserved, and the curves can be animated. - Slop is a catalog, not a vibe. Eyebrows (S01), presenter cues on slides (S02) and process narration (S03) block delivery. The linter runs on the rendered DOM, so it also catches text injected by JavaScript.
- Your template, measured.
scan_template.pyreports the layouts and title positions that the template's own slides use, so the deck sits inside the template rather than imitating it. - Libraries first, AI second, labels always editable. Illustrations come first from
existing medical libraries: Servier Medical Art (exported at full resolution from its
vector PowerPoint kits) and Bioicons (
bioicons.pysearches ~2,800 icons and writes the credits). Only when no library has the picture is one generated, with ChatGPT or Gemini, whichever account you have, through your own signed-in browser and with no text in the pixels. Its anatomy is then checked against a reference. Labels are laid out as editable text with leader lines (label_figure.py, or native text boxes in PPTX). - Motion graphics instead of videos. A mechanism or a pathway is assembled from Bioicons parts (cells, antibodies, receptors) and animated in CSS, so it loops inside the slide like a GIF. It stays sharp on any projector, weighs kilobytes, carries a caption per stage, and pauses on a poster frame for PDF export and screenshots.
- Motion that doesn't stutter. Only transform and opacity are animated. The render checker measures frame timing; the demo's curve reveal and both motion graphics run at a 16.6–16.7 ms median frame interval (60 fps).
Install
Claude Code
/plugin marketplace add drtranquanghung91-vn/grand-rounds
/plugin install grand-rounds@grand-rounds
Or for one session from a clone: claude --plugin-dir path/to/grand-rounds.
On Claude Code the plugin also brings three hooks:
- Routing. A prompt that asks for slides or a presentation gets a reminder to start from the orchestrator and to open with the interview. With many plugins installed, Claude Code drops the descriptions of rarely used skills, and a request could otherwise go straight to a builder.
The other two act only inside a talk folder:
- Plan gate. Writes to
build/andout/, and the deck builders, are refused untilSTATUS.mdrecords that you approvedplan.md. The gate is code, so an agent in a hurry cannot talk its way past it.GRAND_ROUNDS_NO_GATE=1switches it off. - Slop on save. Each slide file saved under
build/orout/is linted at once, and blocking findings (eyebrows, presenter cues, process notes) go straight back to the agent.
Codex
The repository ships a Codex plugin manifest (.codex-plugin/plugin.json) and a marketplace
file (.agents/plugins/marketplace.json). Each skill also has an agents/openai.yaml, and
/grill-deck and /audit-deck are marked as explicit-only. If your Codex version has no
plugin installer, copy or link the skills:
git clone https://github.com/drtranquanghung91-vn/grand-rounds
cp -r grand-rounds/skills/* ~/.agents/skills/
For subagents, enable [features] multi_agent = true in ~/.codex/config.toml.
Antigravity
agy plugin install https://github.com/drtranquanghung91-vn/grand-rounds
Antigravity has no Skill tool, so the skills tell the model to read a skill's SKILL.md
when it applies. Subagents use invoke_subagent.
Status of v0.2.1: the Claude Code plugin and marketplace manifests pass
claude plugin validatein CI, and the hooks were tested live in Claude Code. The skills were exercised in behaviour scenarios and every script by unit tests on Linux, Windows and macOS. The Codex and Antigravity manifests follow the layout Superpowers uses for those harnesses but have not yet been installed end-to-end. Reports are welcome.
Tools the scripts use
| Need | Install |
|---|---|
| Everything except the items below | Python 3.10+ (standard library only) |
| Lifting figures from PDFs | pip install pymupdf |
| Labels on illustrations | pip install pillow |
| Bioicons search and download | nothing extra (standard library; uses the GitHub API) |
| AI-generated illustrations | a browser tool (Playwright MCP, Claude in Chrome, Antigravity browser) signed in to your ChatGPT or Gemini account |
| PPTX build and checks | pip install python-pptx |
| HTML render check, SVG → PNG | pip install playwright, then python -m playwright install chromium, or use an installed Edge or Chrome |
| PPTX renders for visual QA | PowerPoint (Windows) or LibreOffice |
| PubMed through MCP (optional) | any PubMed MCP server; otherwise the bundled pubmed.py is used |
Try it
Make a 10-minute journal club deck on the attached paper.
I need to present our hospital's case of drug-induced liver injury at grand rounds, 15 minutes, PowerPoint, template attached.
Summarise what changed in the 2025 heart failure guideline for our residents, 20 minutes.
/audit-deck slides/conference-talk.pptx
The agent starts with a single round of numbered questions. Reply "yes" to accept every recommendation, or answer the ones you care about.
Examples
examples/fictional-trial/ is a complete journal-club run on a
fictional trial. Every stage's file is present: brief, plan, claims, figures manifest,
built deck and both audit reports. Open out/nova1-journal-club.html in a browser and use →
to step through it, L for the laser, C to circle and N for notes.
examples/heart-anatomy/ shows the illustration routes on a
teaching topic:
- a Servier Medical Art drawing with labels added as text;
- the four Servier drawings of the cardiac cycle played as a loop;
- an illustration generated with ChatGPT and checked against Servier. The check found that the vessels on the left are drawn into the right atrium; that error is left unlabelled and recorded in the manifest.
Repository layout
skills/ one folder per skill: SKILL.md, references, scripts/, agents/openai.yaml
medical-deck/roles/ subagent briefs for stages 4–7
examples/fictional-trial/ an end-to-end journal-club run with every intermediate file
examples/heart-anatomy/ teaching slides: Servier and AI illustrations, labels, a cycle loop
tests/unit/ tests for every script (python -m unittest discover -s tests/unit)
tests/scenarios/ RED/GREEN behaviour scenarios for the skills
hooks/ Claude Code hooks: plan gate, slop on save
.github/workflows/ CI: unit tests on Linux, Windows, macOS; plugin validation
docs/ architecture and per-harness notes
.claude-plugin/ .codex-plugin/ .agents/ .antigravity-plugin/ harness manifests
Testing
python -m unittest discover -s tests/unit -v
CI runs the same tests on Linux, Windows and macOS on every push, plus
claude plugin validate on the plugin and marketplace manifests.
The skills were written test-first, as Superpowers prescribes. Each behaviour was first run
on an agent without the skills, and the failures were recorded in
tests/scenarios/BASELINE.md. The skills were then written
to fix those failures, and the scenarios re-run with them loaded
(tests/scenarios/README.md).
Acknowledgements
Grand Rounds borrows ideas, not code, from these projects. Thank you to their authors.
- obra/superpowers: skills as methodology, TDD for skills, multi-harness packaging
- mattpocock/skills: the
grillingdesign-tree interview, user- vs model-invoked skills - Gabberflast/academic-pptx-skill: action titles and academic storytelling
- kgraph57/medical-slide-templates: medical slide patterns and safety gates
- kau10082/slide-verify: "a real paper does not make the number right", verification ledgers
- mpuig/agent-slides, Rich627/slides-skill, vedraut/slidesage, openai/skills: composable slide skills, spec-driven rendering, render-and-check loops
- HKUDS/Paper2Slides and OpenDCAI/Paper2Any: paper-to-slides pipelines
- Illustration libraries the figures skill points to: Servier Medical Art (CC BY 4.0) and Bioicons
Disclaimer
Grand Rounds helps prepare presentations. It does not give medical advice. The presenter is responsible for the content, for checking every claim against its source, for patient consent and de-identification, and for the right to reuse published figures.
Licence
MIT © 2026 Trần Quang Hưng. The licence covers this repository's code and text. The Servier Medical Art and Bioicons images in the examples keep their own CC BY licences (see NOTICE). The MIT licence does not extend to third-party figures or illustrations you add to your own decks.
// faq
What is grand-rounds?
Grand Rounds: evidence-first medical presentations for Claude Code, Codex & Antigravity. Grills you first, plans with your approval, traces every number to a source, lifts original Kaplan–Meier vectors, builds HTML or PPTX in your template, and audits for AI slop and citation errors.. It is open-source on GitHub.
Is grand-rounds free to use?
grand-rounds is open-source under the MIT license, so it is free to use.
What category does grand-rounds belong to?
grand-rounds is listed under skills in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/grand-rounds)
// retro hit counter
[](https://claudeers.com/grand-rounds)
// reviews
// guestbook
// related in Claude Skills
An agentic skills framework & software development methodology that works.
AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…
💫 Toolkit to help you get started with Spec-Driven Development