Agent skill

Scholar Slides

by luwill in luwill/research-skills

A skill your agent uses when the user wants a research paper, arXiv/DOI link, or research topic turned into academic slides — journal club / lab meeting (组会汇报), thesis defense (答辩幻灯片), or conference…

MITAuto-check passedDocuments & Office

Install Scholar Slides

skills CLI
$ npx skills add luwill/research-skills --skill scholar-slides -a claude-code

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

GitHub CLI
$ gh skill install luwill/research-skills scholar-slides --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/luwill/research-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/scholar-slides .claude/skills/scholar-slides && 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
scholar-slides
GitHub stars
858
Token cost
~1.9k tokens
SKILL.md length
774 words
Files
125 (incl. scripts, references, assets)
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user wants a research paper, arXiv/DOI link, or research topic turned into academic slides — journal club / lab meeting (组会汇报), thesis defense (答辩幻灯片), or conference…

  • Works in 7 steps: Ingest → typed digest —… → Deck-type & parameters —… → Narrative outline —… → …
  • The user wants a research paper
  • SKILL.md covers Locked stack (see…, The non-negotiable integrity…, Pipeline (7 stages, 3 human… and Scripts (scripts/), plus 2 more sections
  • Calls node, npm and npx

What it does

Scholar Slides is an agent skill from luwill/research-skills. Use when the user wants a research paper, arXiv/DOI link, or research topic turned into academic slides — journal club / lab meeting (组会汇报), thesis defense (答辩幻灯片), or conference / job talk (学术报告) — or shares a paper and asks to "make slides / 做成 PPT / 讲一下这篇论文", especially when equations, numbers, figures, and citations must stay accurate and editable. NOT for marketing/pitch decks with no scholarly source, NOT for writing the paper itself, and NOT for stylized visual/image decks (use paper-slide-deck for those)…

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 130 other files, including scripts, reference files and assets (for example `IMPLEMENTATION_PLAN.md`, `README.md` and `benchmarks/README.md`).

It sits in Documents & Office, covering Slides and decks, Citation management and Academic paper search. It works with arXiv. The repository describes itself as: Some commonly used research experiences and processes are encapsulated into Agent skills. The licence is MIT.

When your agent uses it

  • The user wants a research paper
  • Research topic turned into academic slides — journal club / lab meeting (组会汇报)
  • Thesis defense (答辩幻灯片)
  • Conference / job talk (学术报告) —

Example prompts

  • “make slides / 做成 PPT / 讲一下这篇论文”
  • “/scholar-slides”

Requirements

  • Python 3
  • Node.js

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Ingest → typed digest — references/ingestion.md. Run
  2. Deck-type & parameters — references/deck-types.md. Pick deck type (default 组会),
  3. Narrative outline — references/narrative.md. Re-sequence the paper into talk order;
  4. Per-slide spec — references/slide-spec.md. One self-contained, on-disk spec per slide
  5. Render — references/math.md, references/figures-tables.md, references/citations.md,
  6. Self-review QA — references/qa-self-review.md + references/integrity.md, then the
  7. Export — references/export.md. Vector PDF (projection) + speaker notes + editable PPTX;

What it can do on your machine

Read from SKILL.md and the folder at commit 633d2b5. 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 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • node
    • npm
    • npx
    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm and npx, which can reach the network depending on how they are called.

    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

Scholar Slides loads about 1.9k tokens when it runs, and up to ~17k if it reads all its reference files. Until then it costs about 147 tokens; SKILL.md has 774 words of instructions outside code blocks.

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

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 luwill/research-skills at commit 633d2b5, republished under its MIT licence (© luwill). 774 words, ~1,920 tokens.

Download SKILL.mdSave it as .claude/skills/scholar-slides/SKILL.md (or your agent's skills folder). This skill also uses 124 other files; get the full folder from GitHub.
name
scholar-slides
description
Use when the user wants a research paper, arXiv/DOI link, or research topic turned into academic slides — journal club / lab meeting (组会汇报), thesis defense (答辩幻灯片), or conference / job talk (学术报告) — or shares a paper and asks to "make slides / 做成 PPT / 讲一下这篇论文", especially when equations, numbers, figures, and citations must stay accurate and editable. NOT for marketing/pitch decks with no scholarly source, NOT for writing the paper itself, and NOT for stylized visual/image decks (use paper-slide-deck for those). No poster or grant-pitch workflow exists in this skill.

scholar-slides

Turn a research paper (or topic) into a fidelity-first academic slide deck. Academia inverts the priorities of a normal deck tool: source fidelity > polish, evidence > persuasion, editability > flash. Equations, tables, numbers, figures, and citations stay true text/vector and traceable to the source — never rasterized by an image model, never fabricated.

Design rationale and the survey it is built on live in docs/; build plan in IMPLEMENTATION_PLAN.md.

Locked stack (see docs/03-design-proposal.md §0)

  • Render backend: reveal.js + KaTeX → vector PDF (Playwright) + editable PPTX (parity-tested). Beamer later.
  • Default deck type: lab meeting / journal club (组会) — reading-first, high density.
  • Citations: Zotero-first (mcp__zotero__*), Crossref/arXiv/DOI fallback.
  • Language: bilingual, English-default.

The non-negotiable integrity gate (ALWAYS on — see references/integrity.md)

Apply at every stage; enforced at Checkpoint 3:

  • Never fabricate numbers, citations, or figures. Everything traces to the source digest.
  • Math/tables/citations stay vector/text — never an image model's pixels.
  • Reuse real figures (bbox-cropped + Figure N [cite]); a conceptual schematic may be redrawn only if labeled "redrawn, not from source".
  • Flag, don't invent: an unresolved figure/number/citation emits a visible [MISSING: …] / [UNVERIFIED: …] placeholder surfaced to the user — never a silent fill.
  • Provenance is mandatory: every reused asset carries its source; every claim is traceable.

Pipeline (7 stages, 3 human checkpoints)

INPUT → 1.INGEST/DIGEST → [CKPT-1] → 2.DECK-TYPE → 3.OUTLINE → [CKPT-2]
      → 4.PER-SLIDE SPEC → 5.RENDER → 6.SELF-REVIEW(QA) → [CKPT-3] → 7.EXPORT
  1. Ingest → typed digest — references/ingestion.md. Run scripts/prepare_source.py <pdf|arXiv id|arXiv URL> to build the digest-input bundle (text, figure/table inventory with bboxes, cropped figures), then synthesize the typed paper digest from it (grounded in the bundle, never invented). → [CKPT-1] confirm the digest with the user (contributions, headline result, figure→slide map, any FLAGGED asset).
  2. Deck-type & parameters — references/deck-types.md. Pick deck type (default 组会), audience, time budget → slide budget, density register, required archetypes.
  3. Narrative outline — references/narrative.md. Re-sequence the paper into talk order; action-title per slide; arc-tension check. → [CKPT-2] approve the story arc.
  4. Per-slide spec — references/slide-spec.md. One self-contained, on-disk spec per slide (layout, content, equations, figures, citations, speaker notes).
  5. Render — references/math.md, references/figures-tables.md, references/citations.md, references/charts.md, references/design-system.md, references/export.md. reveal.js + KaTeX; real tables; real bbox-cropped figures (furniture-stripped; one panel per slide for multi-panel); data-bound redrawn charts; Zotero/BibTeX citations. Pick the visual theme via meta.theme (journal-club default / conference).
  6. Self-review QA — references/qa-self-review.md + references/integrity.md, then the aesthetics loop in references/aesthetics-review.md. Integrity scan + static validator + render screenshots + narrative/timing checks; the render pass also measures geometry deterministically (canvas voids, figure-text projected below the 12px legibility floor). Then score the rendered pixels on the 6-dimension rubric (adversarial persona), write the scores to <deck>/aesthetics_report.json (schema in aesthetics-review.md), and rework any slide with a dimension ≤ 2 or total < 18 until the report's rework list is empty — the QA gate flags a missing report (P3) and an unspent rework list (P2). It also nudges on bullet-ratio and layout monotony. → [CKPT-3] truth sign-off: review every [MISSING]/[UNVERIFIED] and generated asset.
  7. Export — references/export.md. Vector PDF (projection) + speaker notes + editable PPTX; verify the PPTX preserves the spec natively with scripts/verify_pptx_parity.py (protects the minimal-manual-edits promise). Regress the whole corpus with node scripts/run_benchmark.mjs.

Read only the reference file for the stage you are in (progressive disclosure — never glob references/). Each stage reads the confirmed artifact of the prior stage — the digest (Stage 1, user-confirmed at CKPT-1) and then deck.json — rather than re-deriving from the paper.

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

Scripts (scripts/)

Ingestion — pipeline stage 1 (Python, via ./.venv/bin/python; deps in requirements.txt):

  • prepare_source.py — Stage 1 entry point: PDF/arXiv → digest-input bundle.
  • ingest_pdf.py — PyMuPDF text+layout extraction; arXiv-id detection.
  • detect_figures.py — figure/table caption inventory + bounding-box localization.
  • crop_figure.py — clean single-figure bbox crop (no neighbor columns).

Deck build & render — pipeline stage 5 (Node, via node; deps in package.json, npm install + npx playwright install chromium):

  • build_deck.mjs — render entry point: deck.json → self-contained reveal.js deck.
  • render_deck.mjs — deck → one-page-per-slide vector PDF (and per-slide PNGs for QA).
  • lib/ — layouts (registered-layout lock), math (KaTeX), table, figure, escape, qa.

Citations & QA — pipeline stages 5–6 (citations = Python; QA = Node):

  • fetch_bib.py — citation resolver (arXiv/DOI/Crossref) with order-sensitive title verification.
  • qa_report.mjs — CKPT-3 gate: integrity scan + validate_deck.mjs + verify_slides.mjs + timing.

Speaker notes (Node):

  • speaker_notes.mjs — deck.json → notes.md handout + bilingual talk-length estimate.
  • lib/notes.mjs — timing + handout pure logic; design system in assets/templates/themes/.

Export & charts — pipeline stage 7 (export = Node; charts = Python):

  • export_pptx.mjs — deck.json → editable PPTX (native text/tables/notes; figures+equations as images).
  • make_chart.py — chart spec → data-bound Okabe–Ito plot (values plotted verbatim).

Tests: ./.venv/bin/python -m pytest (Python) and node --test tests/deck.test.mjs tests/qa.test.mjs tests/notes.test.mjs tests/pptx.test.mjs (Node).

Learnings: read before changing pipeline behavior

learnings/ holds post-incident notes with measured numbers (figure-size vertical budget, craft rules vs looks). Scan it before changing rendering, sizing, or QA behavior; append a dated note after any rework-worthy surprise.

Build status

The whole pipeline is implemented and validated on real papers. Not built: Beamer export, OCR for scanned PDFs, draft-deck ingestion; conference/答辩 deck types are authoring guidance in references/deck-types.md (no dedicated code). A deck is "done" only after the CKPT-3 human truth sign-off — the gate surfaces defects but cannot certify truth.

© luwill, 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 124 other files (scripts, references, assets) in scholar-slides of luwill/research-skills.

  • SKILL.md
  • .gitignore
  • IMPLEMENTATION_PLAN.md
  • LICENSE
  • README.md
  • assets/templates/deck-stage/print.css
  • assets/templates/deck-stage/tokens.css
  • assets/templates/deck-stage/viewport-base.css
  • assets/templates/themes/base-theme.css
  • assets/templates/themes/conference.css
  • assets/templates/themes/journal-club.css
  • benchmarks/README.md
  • benchmarks/eval/scorecard.md
  • benchmarks/manifest.json
  • docs
  • … and 110 more

Open the folder on GitHubat commit 633d2b5

Compare with similar skills

Scholar Slides 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.

Scholar Slides compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Scholar Slides this skillluwill/research-skills858—~1.9kAutomated safety check: PassMIT
Latex Paper ArtifactBingHanOfUESTC/open_agent_team106—~635Automated safety check: PassMIT
Write Paperfrenzymath/Danus475—~18kAutomated safety check: PassApache-2.0
Huashu Reportalchaincyf/huashu-report441—~1.4kAutomated safety check: PassMIT
Ref Downloaderltczding-gif/ref-downloader139—~5.9kAutomated safety check: PassMIT
SearchMuuuun/luxas1.2k—~2.3kAutomated safety check: WarnMIT

Similar skills

  • Latex Paper Artifact

    BingHanOfUESTC/open_agent_team

    A skill your agent uses when producing the final arXiv-style LaTeX paper, BibTeX, figures, tables, reproducibility statement, appendix, and artifact manifest.

    106 GitHub stars~635 tokensUpdated 3 mo ago
    Documents & OfficeAuto-check passed
  • Write Paper

    frenzymath/Danus

    Turn a project's verified fact graph into a publishable LaTeX paper in a configurable house style — a standalone amsart .tex with a real bibliography, compiled to PDF.

    475 GitHub stars~18k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Huashu Report

    alchaincyf/huashu-report

    做机构级研究报告与学术论文——行业报告、白皮书、年度调研、数据洞察、arXiv论文,也含16:9咨询deck型报告(一页一结论)。定结构、写发现、建图表视觉系统。规范提炼自2026年顶级机构报告实测。单篇文章、纯演示PPT不适用(走design/slides)。

    441 GitHub stars~1.4k tokensUpdated 24 days ago
    Research & ScienceAuto-check passed
  • Ref Downloader

    ltczding-gif/ref-downloader

    A skill your agent uses when the user asks to batch-download academic PDFs with ref-downloader — either ALL references of one paper (Mode A: DOI or PDF input), OR a custom batch of papers (Mode B…

    139 GitHub stars~5.9k tokensUpdated 4 mo ago
    Research & ScienceAuto-check passed
  • Search

    Muuuun/luxas

    Unified academic paper search, citation chains, paper download (arXiv LaTeX/PDF, Sci-Hub), figure extraction from papers, LaTeX source reading, BibTeX fetching, web search, and browser automation…

    1.2k GitHub stars~2.3k tokensUpdated 1 mo ago
    Research & ScienceAuto-check: warnings
  • Papers Skill

    majiayu000/claude-skill-registry

    Skill for academic research workflows: search Semantic Scholar (200M+ papers), inspect citations, download arXiv PDFs, and extract PDF text.

    666 GitHub starsUsed in 2 repos~2.1k tokens
    Research & ScienceAuto-check passed

More from luwill/research-skills

  • Paper Slide Deck

    luwill/research-skills

    A skill your agent uses when the user wants visually striking, shareable slide-deck IMAGES from any content — an article, blog post, topic, or paper — where look-and-feel matters more than editable…

    858 GitHub stars~4.6k tokensUpdated 8 days ago
    Auto-check passed
  • Research Proposal

    luwill/research-skills

    A skill your agent uses when the user asks to write or draft a PhD / doctoral research proposal, research plan, 研究计划书, or 开题报告 — a forward-looking plan of background, gap, research questions…

    858 GitHub stars~4.4k tokensUpdated 8 days ago
    Auto-check: notes
  • Lit Search

    luwill/research-skills

    Runs an exhaustive time-windowed literature search over a research topic and delivers a quality-tiered DOI list plus a matching formatted reference list, with measurable recall (gold-set recall…

    858 GitHub stars~3.5k tokensUpdated 8 days ago
    Auto-check: notes
  • Medical Imaging Review

    luwill/research-skills

    A skill your agent uses when the user asks to plan, conduct, document, synthesize, or draft a medical imaging AI narrative review or method survey, scoping review, or systematic review with…

    858 GitHub stars~3.8k tokensUpdated 8 days ago
    Auto-check passed

Works with

Questions about Scholar Slides

What does Scholar Slides do?

A skill your agent uses when the user wants a research paper, arXiv/DOI link, or research topic turned into academic slides — journal club / lab meeting (组会汇报), thesis defense (答辩幻灯片), or conference…. Scholar Slides is an agent skill from luwill/research-skills. Use when the user wants a research paper, arXiv/DOI link, or research topic turned into academic slides — journal club / lab meeting (组会汇报), thesis defense (答辩幻灯片), or conference / job talk (学术报告) — or shares a paper and asks to "make slides / 做成 PPT / 讲一下这篇论文", especially when equations, numbers, figures, and citations must stay accurate and editable.

When should I use Scholar Slides?

Scholar Slides fits situations like: the user wants a research paper; research topic turned into academic slides — journal club / lab meeting (组会汇报); thesis defense (答辩幻灯片); conference / job talk (学术报告) —.

How do I install Scholar Slides in Claude Code?

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

How do I install Scholar Slides in Codex?

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

Can I use Scholar Slides 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 luwill/research-skills --skill scholar-slides -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/scholar-slides, .gemini/skills/scholar-slides, .github/skills/scholar-slides and .opencode/skills/scholar-slides in your project.

What does Scholar Slides need to run?

Going by SKILL.md and its folder, Scholar Slides needs the command-line tools its instructions call (node, npm, npx and python). Our summary lists: Python 3; Node.js.

Does Scholar Slides access the network?

SKILL.md contains no URLs. Its commands use npm and npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Scholar Slides 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 Scholar Slides use?

Scholar Slides is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Scholar Slides use?

About 1.9k tokens (SKILL.md is roughly 7.7k 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 15k tokens, read only when the agent opens those files.

What are the alternatives to Scholar Slides?

Skills that share tags, products or a category with Scholar Slides: Latex Paper Artifact (BingHanOfUESTC/open_agent_team, 106 stars), Write Paper (frenzymath/Danus, 475 stars), Huashu Report (alchaincyf/huashu-report, 441 stars) and Ref Downloader (ltczding-gif/ref-downloader, 139 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Scholar Slides?

luwill (a GitHub user) maintains it in luwill/research-skills, which has 858 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on September 30, 2026.

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