piped-clover — research → deck, PowerPoint & mind map

What you get

One paste in. Three linked artifacts out — each with the source citation and a personalised "So What — For You" takeaway.

📊

Marp slide deck

8–16 clean slides, auto-styled by content type. Presentation-ready.

slides.md · .pdf · .html

📈

PowerPoint

Editable deck with native charts — only where the source has real numbers.

deck.pptx

🧠

Mind map

Interactive, zoomable map of the whole argument, with source deep-links.

mindmap.html

How it works

You paste the text; Claude follows SKILL.md. Mechanical parsing is done by small scripts, the judgement by the model. Click a file chip to jump to it.

Paste the source

A transcript, article, show notes, or your own notes — plus the title & author. No transcript? The skill points you to copy-paste steps for YouTube & Apple Podcasts.

getting-transcripts.md

Extract structure

A Python parser pulls headings, bullets, numbers, frameworks & timestamps into structure.json. The model then fills semantic gaps.

extract_structure.py

Pick a visual style

A rubric chooses framework-first, narrative-arc, or concept-hierarchy from what the content actually is.

style-rubric.md

Write & render the deck

Claude writes themed Marp slides; the skill renders them to PDF + HTML.

render_marp.shmarp-theme.css

Build the mind map

Writes the map markdown and renders it to a zoomable interactive page.

render_markmap.sh

"So What — For You"

A grounded takeaway slide. Uses an optional ~/.claude/profile.md if present; otherwise stays source-grounded.

Generate the PowerPoint

Builds a slide spec + chart CSVs, then hands off to Claude's built-in pptx skill (present in both Claude Code & Cowork).

build_pptx_payload.py

Install

Claude Cowork

Desktop app · no terminal · for people without Claude Code

Download & unzip the skill (button at top).
In the Claude desktop app → Cowork → Customize → Skills / Extensions → + Add, point it at the skills/piped-clover folder.
Connect a folder for outputs (Cowork only writes to folders you connect).
Paste a transcript and ask for "a deck and mind map from this."

Managed Cowork: the renderers fetch small packages from npm/PyPI on first run. If they're blocked, an admin needs to allow that egress — you'll still get the .md + .pptx without it.

Claude Code

Terminal · symlink into your skills dir

Download & unzip the skill.
From the unzipped piped-clover folder, run:

mkdir -p ~/.claude/skills
ln -sfn "$(pwd)/skills/piped-clover" \
  ~/.claude/skills/piped-clover

Paste a transcript and say "turn this into slides and a mind map." Outputs land in ~/research-visuals/{topic}/.

Needs Node for the renderers — auto-installed on first run (macOS brew / Linux apt), or brew install node yourself.

🍀 piped-clover