luwill/research-skills
Some commonly used research experiences and processes are encapsulated into Agent skills.
Research Skills – Claude Code Skills for Academic Work
What it is – A set of five Claude Code “skills” (plug‑in style command‑line tools) that help researchers automate parts of the academic workflow, especially for AI‑related papers. The skills cover:
| Skill | Main purpose |
|---|---|
| medical‑imaging‑review | Build a rigor‑checked, citation‑integrity‑driven literature review for medical‑imaging AI. |
| paper‑slide‑deck | Turn any document into a set of AI‑generated, stylised slide images (17 visual themes). |
| research‑proposal | Generate a PhD‑level research proposal in a Nature‑Reviews style, with verified references. |
| scholar‑slides | Create an editable, vector‑based slide deck where every equation, table, figure and citation is faithfully reproduced from the source. |
| lit‑search | Perform exhaustive, time‑windowed literature retrieval with a measurable recall report. |
How it works
- Installation – Each skill is a folder that you copy into
~/.claude/skills/. Some skills (scholar‑slides, lit‑search) ship aninstall.shthat creates a Python virtual‑env, installs Node/npm packages and any required system fonts. - Invocation – Skills are triggered by a slash command (e.g.,
/lit-search) or a CLI call such aspaper-slide-deck content.md --style watercolor. The README lists the exact trigger strings for each skill. - Core philosophy – All writing‑related skills share a citation‑integrity discipline: stable cite‑keys, a claim‑ledger, and an audit script that never silently passes a manuscript. The integrity guardrails are documented in
docs/citation-integrity-core.md.
Quick look at each skill
1. medical‑imaging‑review
- Target – Systematic‑style reviews of AI for medical imaging.
- Workflow – Choose a route (narrative, method‑survey, scoping, systematic). The tool scaffolds a project (
init_review_project.py) with a timestamped config, claim ledger, bibliography and checklist files. An audit script (audit_manuscript.py) cross‑checks every citation against the ledger and reports failures, warnings or “not assessed”. - Outputs – Markdown manuscript,
references.bib,claim_ledger.csv, and a PRISMA‑style checklist.
2. paper‑slide‑deck
- Target – Visual, share‑ready slide images (not editable). Useful for quick overviews or social media.
- Key steps – Detect figures in a PDF, map each figure to a full‑page slide, generate an image via the Gemini‑3‑pro‑image API, then merge into PPTX or PDF.
- Limitation – Math and data are rasterised; not suitable for a defense where precise numbers must stay editable.
3. research‑proposal
- Target – Draft PhD proposals or research plans (English or Chinese).
- Process – Five‑phase pipeline: requirements → literature collection (with verification) → outline approval → section‑by‑section writing → final Markdown output.
- Guardrails – Every reference is checked against DOI/PMID/arXiv or a Zotero library; unverifiable entries are flagged.
- Typical output – 2‑4 k word proposal, 25‑50 verified references, 3‑5 figure suggestions, ready for pandoc conversion.
4. scholar‑slides
- Target – High‑fidelity, editable slide decks for journal clubs, conference talks, etc.
- Features – Vector equations via KaTeX, real tables, exact figure crops, bilingual support, and an integrity QA gate that flags missing or unverified content.
- Outputs – Reveal.js HTML deck, vector PDF, and an editable PPTX with speaker notes.
- Known issue – Figure localisation works best on single‑column layouts; two‑column papers may need manual confirmation.
5. lit‑search
- Target – Exhaustive literature retrieval with a transparent recall metric.
- Approach – Multi‑source crawling (OpenAlex, PubMed, Crossref, etc.) with full pagination, citation‑closure, and a “coverage_report.md” that lists what was not retrieved.
- Depth tiers – Different cost/precision levels; you can preview time and cost with
uv run lit depths. - Outputs –
dois.md,references.md(formatted in several citation styles),references.bib, PRISMA summary, coverage report, and a CSV queue for human screening.
Who might use this?
- Researchers preparing systematic reviews or proposals who want reproducible, auditable workflows.
- Graduate students needing quick, citation‑safe slide decks for seminars.
- Lab managers who want a deterministic way to collect all papers on a topic and quantify search completeness.
- Anyone using Claude Code who prefers a plug‑in model rather than writing custom scripts.
License
MIT – free to use, modify, and redistribute.
Bottom line – The repository is a genuine collection of open‑source tools that automate scholarly writing and presentation tasks while enforcing strict citation integrity. It is squarely in the AI‑assisted research‑automation space.
Related
- Project
- Project
- Project
- Project
- Project