Skip to content
Back to search

research-skills

Some commonly used research experiences and processes are encapsulated into Agent skills.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/luwill--research-skills/badge.svg)](/listings/luwill--research-skills)

HTML

<a href="/listings/luwill--research-skills"><img src="/api/listings/luwill--research-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Copy the desired skill folder into your Claude Code skills directory:

cp -r medical-imaging-review ~/.claude/skills/
cp -r paper-slide-deck       ~/.claude/skills/
cp -r research-proposal      ~/.claude/skills/
cp -r scholar-slides         ~/.claude/skills/
cp -r lit-search             ~/.claude/skills/

`scholar-slides` and `lit-search` carry their own toolchains; after copying, provision them once:

cd ~/.claude/skills/scholar-slides && ./install.sh
cd ~/.claude/skills/lit-search     && ./install.sh   # needs uv + Python 3.11+

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 277 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Research Skills
  2. A collection of Claude Code skills for academic research workflows.
  3. ## Skills
  4. | Skill | Description | Trigger |
  5. |-------|-------------|---------|
  6. | [medical-imaging-review](./medical-imaging-review/) | Write comprehensive literature reviews for medical imaging AI | `/medical-imaging-review`, "review paper", "survey", "综述" |
  7. | [paper-slide-deck](./paper-slide-deck/) | Stylized slide **images** (17 T2I aesthetic styles) for reading & sharing — any content | `/paper-slide-deck content.md --style watercolor` |
  8. | [research-proposal](./research-proposal/) | Generate PhD research proposals with Nature Reviews-style academic writing | `/research-proposal`, "research proposal", "PhD proposal", "研究计划" |
  9. | [research-paper](./research-paper/) | Draft **original research articles** (IMRaD) from your completed experiments — results-first, reporting-checklist bound | `/research-paper`, "write the paper", "论文写作" |
  10. | [scholar-slides](./scholar-slides/) | Fidelity-first academic decks for a live talk — vector equations, extracted figures, grounded citations, editable PPTX | "make slides", "组会 PPT", "答辩幻灯片", a paper PDF / arXiv / DOI |
  11. | [lit-search](./lit-search/) | Exhaustive time-windowed literature retrieval with **measurable recall** — quality-tiered DOI list + formatted references | `/lit-search`, "systematic review", "开题报告的文献检索/查全部分", "把某方向近 N 年文献检索全" |
  12. > **Slides from a paper? Two different tools, on purpose.** Use **scholar-slides** for a faithful,
  13. > editable *live talk* — equations, numbers, tables, and citations stay exact and projector-ready.
  14. > Use **paper-slide-deck** for *stylized visual images* to read or share, where look-and-feel
  15. > matters more than editable precision (its slides are AI-generated images, so math and data are
  16. > not editable and can be garbled — don't use it for a defense or a results-heavy talk).
  17. > **Doing a review? Two stages, two skills.** **lit-search** builds the *corpus* — it finds the
  18. > papers and proves how complete the search was. **medical-imaging-review** writes the *review* from
  19. > papers you already have. Running a systematic review end to end means lit-search first, then
  20. > medical-imaging-review over its `dois.md`.
  21. > **Shared anti-fabrication core.** All five writing/rendering skills instantiate the same
  22. > five-rule citation-integrity discipline; the variants are reconciled at development time in
  23. > [docs/citation-integrity-core.md](./docs/citation-integrity-core.md).
  24. ## Installation
  25. Copy the desired skill folder into your Claude Code skills directory:
  26. ```bash
  27. cp -r medical-imaging-review ~/.claude/skills/
  28. cp -r paper-slide-deck ~/.claude/skills/
  29. cp -r research-proposal ~/.claude/skills/
  30. cp -r research-paper ~/.claude/skills/
  31. cp -r scholar-slides ~/.claude/skills/
  32. cp -r lit-search ~/.claude/skills/
  33. ```
  34. `scholar-slides` and `lit-search` carry their own toolchains; after copying, provision them once:
  35. ```bash
  36. cd ~/.claude/skills/scholar-slides && ./install.sh
  37. cd ~/.claude/skills/lit-search && ./install.sh # needs uv + Python 3.11+
  38. ```
  39. ---
  40. ## Medical Imaging Review Skill
  41. Plan, conduct, and draft a medical imaging AI review whose every claim audits back to first sources — narrative review, method survey, scoping review, or systematic review **with qualitative synthesis only** (meta-analysis / umbrella review are explicitly out of scope and route out to a specialized methods workflow).
  42. ### Features
  43. - **Four-route contract** — `narrative` / `method-survey` / `scoping` / `systematic` route tokens frozen at intake; matching reporting standards (PRISMA 2020/ScR, QUADAS-3, CLAIM 2024, TRIPOD+AI, PROBAST-family, SWiM) per route
  44. - **Immutable project contract** — `init_review_project.py` scaffolds a timestamped project (`review_config.yaml`, `REVIEW_CONTEXT.md`, `claim_ledger.csv`, `references.bib`, `manuscript.md`, route-specific checklists) with atomic staging; the route cannot silently change after collection begins
  45. - **Stable citekeys, never mutable numbers** — the working draft cites `[@smith2024model]`; the target journal's numeric/author-date style is rendered only at final formatting
  46. - **claim_ledger discipline** — one atomic claim–source pair per row (26 columns: metric, direction, evidence excerpt, verification status, …); drafting reads the ledger, not model memory
  47. - **Executable audit with honest semantics** — `scripts/audit_manuscript.py` binds manuscript citekeys ↔ `references.bib` ↔ claim ledger; `gate_status` can be `fail` / `warning` / `not_assessed` but **never `pass`** (a clean audit proves nothing was found wrong, not that the review is correct); exit codes 0/1/2
  48. - **Human gates stay human** — screening, charting/extraction, risk-of-bias, and certainty steps are logged with named roles and never auto-passed
  49. ### Route-aware workflow
  50. 1. Route and configure (intake gate) → 2. Initialize project → 3. Design methods (protocol + search plan frozen before screening) → 4. Collect and register sources → 5. Pass human gates → 6. Synthesize within scope → 7. Draft from verified records → 8. Validate and report status.
  51. ### Files
  52. | Path | Description |
  53. |------|-------------|
  54. | `SKILL.md` | Route contract, project contract, workflow, audit usage |
  55. | `references/REVIEW_TYPES.md` | Route routing + per-route artifacts and gates |
  56. | `references/REPORTING_STANDARDS.md` | PRISMA / QUADAS-3 / CLAIM / TRIPOD+AI / SWiM standards fit |
  57. | `references/WORKFLOW.md` | Phase-by-phase workflow guide (Phase -1 … 6) |
  58. | `references/PARADIGM.md` | Optional exemplar style capture → `style_profile.json` (schema 2.0) |
  59. | `references/CITATION_INTEGRITY.md` | Citekey/claim-ledger verification protocol |
  60. | `references/HALLUCINATION_PATTERNS.md` | LLM hallucination indicators to self-check |
  61. | `references/TEMPLATES.md` | Project file templates (ledger schema, gates, style profile) |
  62. | `references/DOMAINS.md` | Domain-specific method categories and datasets |
  63. | `references/MCP_SETUP.md` | Literature connector configuration and fallbacks |
  64. | `references/QUALITY_CHECKLIST.md` | Pre-submission quality checklist |
  65. | `scripts/init_review_project.py` | Project initializer (atomic, refuses existing targets) |
  66. | `scripts/audit_manuscript.py` | Executable manuscript audit (`scripts/mir_audit/` package) |
  67. | `scripts/import_litsearch.py` | Import a lit-search run as an immutable search export + one `search_log.csv` row (refuses re-import or a missing PRISMA total) |
  68. | `tests/` | Fixture test suite locking the audit and initializer contracts |
  69. ---
  70. ## Paper Slide Deck Skill
  71. Transform any content into stylized, shareable slide **images** (AI-generated), with figure detection and high-resolution page rendering from PDFs.
  72. > Text, math, and data are baked into each image and **not editable** — for a faithful, editable academic talk (组会/答辩/results-heavy) use **scholar-slides** instead.
  73. ### Features
  74. - **Caption-based figure detection** from PDF papers (locates the page; human confirmation recommended for dense two-column layouts)
  75. - **Figure-to-slide mapping** with full-page high-res render + template container (not per-figure bbox cropping)
  76. - **17 visual styles** (academic-paper, sketch-notes, minimal, etc.)
  77. - **Gemini API integration** (`gemini-3-pro-image`) for AI slide generation, with an **enforced** proofread pass: every generated slide needs a recorded disposition bound to its bytes before PPTX/PDF merge
  78. - **PPTX/PDF export** with merge scripts
  79. ### Workflow
  80. 1. Analyze paper and detect figures/tables
  81. 2. Generate outline with auto IMAGE_SOURCE mapping
  82. 3. Extract figures from PDF (or AI-generate)
  83. 4. Apply academic templates
  84. 5. Merge to PPTX/PDF
  85. ### Files
  86. | Path | Description |
  87. |------|-------------|
  88. | `SKILL.md` | Main skill definition and workflow |
  89. | `references/` | Analysis framework, templates, style definitions |
  90. | `scripts/` | Python/TypeScript automation scripts |
  91. ### Scripts
  92. | Script | Purpose |
  93. |--------|---------|
  94. | `generate-slides.py` | Gemini API image generation |
  95. | `detect-figures.ts` | PDF figure/table detection |
  96. | `extract-figure.ts` | PDF page extraction |
  97. | `apply-template.ts` | Academic figure container template |
  98. | `merge-to-pptx.ts` | PPTX generation |
  99. | `merge-to-pdf.ts` | PDF generation |
  100. | `proofread.ts` | Proofread dispositions; merges refuse unproofread AI-generated slides |
  101. ---
  102. ## Research Proposal Skill
  103. Generate high-quality academic research proposals — PhD applications, research plans, 研究计划书 / 开题报告 — following Nature Reviews-style academic writing conventions.
  104. ### Features
  105. - **Structured 5-phase workflow** with a **write-with-verify** content stage: Requirements → Literature (+verification gate) → Outline (approval red line) → Content (section-by-section) → Output
  106. - **Citation-integrity guardrails**: every reference verified to exist (DOI/PMID/arXiv or Zotero) with author and year matching the source — unverifiable entries are flagged, never fabricated
  107. - **Executable citation gate**: `scripts/check_proposal.py` reconciles in-text citations ↔ References both ways (APA author-year or GB/T 7714 `[N]`), fails on mixed styles instead of half-checking, and catches placeholders, AI tells and leftover scaffold instructions (shares its core, byte-identical, with research-paper)
  108. - **Multi-source literature integration**: WebSearch, Zotero MCP, arXiv, PubMed (with tool-portable fallbacks)
  109. - **Bilingual support**: English and Chinese (中文)
  110. - **Domain adaptation**: STEM (incl. computational / ML / AI-for-Science), Humanities, Social Sciences
  111. - **Academic writing style**: prose-based, evidence-calibrated language; reference count follows the argument (no padding quota)
  112. ### Workflow
  113. 1. Gather requirements (topic, domain, language, word count)
  114. 2. Collect literature from multiple sources
  115. 3. Generate outline for user approval
  116. 4. Write full proposal based on approved outline
  117. 5. Output Markdown with quality checklist
  118. ### Files
  119. | Path | Description |
  120. |------|-------------|
  121. | `SKILL.md` | Main skill definition and 5-phase workflow |
  122. | `references/STRUCTURE_GUIDE.md` | Section-by-section writing guide |
  123. | `references/DOMAIN_TEMPLATES.md` | STEM vs Humanities differences |
  124. | `references/WRITING_STYLE_GUIDE.md` | Nature Reviews academic writing style |
  125. | `references/CITATION_INTEGRITY.md` | Reference verification protocol (5 rules, author-year style) |
  126. | `references/QUALITY_CHECKLIST.md` | Quality verification checklist |
  127. | `references/LITERATURE_WORKFLOW.md` | Literature collection workflow |
  128. | `assets/proposal_scaffold_en.md` | English template scaffold |
  129. | `assets/proposal_scaffold_zh.md` | Chinese template scaffold |
  130. ### Output
  131. - Target: 2,000-4,000 words (default ~3,000) for a PhD proposal; 开题报告 follows the institution's required length (常见 10,000–30,000 字)
  132. - References: count follows the argument (typically 25–50; no minimum, no padding), each verified
  133. - 3-5 figure suggestions
  134. - Markdown format (convertible to DOCX/PDF via pandoc)
  135. ---
  136. ## Research Paper Skill
  137. Draft an **original research article** (IMRaD, conference style, or 中文期刊) from work that is
  138. already done. Two disciplines distinguish it from the proposal/review skills:
  139. - **Results-first.** Methods and Results are written from the user's actual materials
  140. (result tables, metrics, figures); anything not supplied is flagged `[PENDING]`, never
  141. filled with a plausible number. A `results_ledger.csv` maps every load-bearing number in
  142. the draft back to its source artifact, and the Phase 5 gates reconcile them.
  143. - **Reporting-checklist bound.** Study type selects a binding checklist at intake
  144. (CLAIM 2024 / TRIPOD+AI / STROBE / STARD / venue reproducibility statement); absent-but-
  145. required items resolve as reporting, disclosure, or a user-accepted gap — never silence.
  146. Citation discipline is the repository's shared five-rule core in journal-style form
  147. ([docs/citation-integrity-core.md](./docs/citation-integrity-core.md)); the related-work
  148. corpus can be built by **lit-search** and consumed directly.
  149. The Phase 5 gates are executable: `scripts/check_paper.py paper_draft.md --ledger
  150. results_ledger.csv --bib references.bib` fails on any metric-like number (decimal, %, `n=`)
  151. the ledger does not cover — including in Chinese prose and bracketed CIs — on `[@citekey]` ↔
  152. `references.bib` orphans in either direction, on placeholder/AI-tell hits, and on reporting-
  153. checklist rows without a disposition. Exit 0 means no mechanical findings, not a correct paper.
  154. ---
  155. ## Scholar Slides Skill
  156. Turn a research paper (or arXiv/DOI link, or a topic) into a **fidelity-first** slide deck — one where every equation, table, number, figure, and citation stays true vector/text and **traceable to the source**, never rasterized by an image model and never fabricated. Where `paper-slide-deck` optimizes visual style via text-to-image, scholar-slides inverts the priority for scholarly work: **source fidelity > polish**, behind an executable integrity gate.
  157. ### Features
  158. - **Fidelity-first rendering** — KaTeX vector equations, real `<table>`/OOXML tables, cited figure crops; numbers grounded against the source, no fabrication
  159. - **Integrity QA gate** — number grounding, `[MISSING]`/`[UNVERIFIED]` flags instead of silent fills, PPTX-parity regression, a scoreable aesthetics rubric
  160. - **Two registers** — journal-club (组会, reading-first) and conference (big-room), via a token-based theme system
  161. - **Bilingual** — English default, full 中文 / CJK support
  162. - **Zotero-first citations** with Crossref / arXiv / DOI fallback
  163. ### Outputs
  164. - Interactive reveal.js deck (with browser speaker view)
  165. - One-page-per-slide **vector PDF**
  166. - **Editable PPTX** (native text, bullets, tables, speaker notes; equations/figures as flagged images)
  167. - Speaker notes with a bilingual talk-time estimate
  168. ### Install & run
  169. ```bash
  170. cd ~/.claude/skills/scholar-slides && ./install.sh # .venv + npm + Chromium, then self-checks
  171. ```
  172. Prereqs: **Python 3.11+, Node 18+.** For Chinese decks on Linux: `sudo apt-get install fonts-noto-cjk` (macOS/Windows already have CJK fonts).
  173. ### Known limitation
  174. Figure localization is layout-dependent — ~95–100% on single-column / arXiv / Nature-style papers, ~75% on dense IEEE/TPAMI two-column pages. Low-confidence crops are **flagged for you to confirm**, never silently wrong. Stress-tested across cross-layout papers with 0 crashes; on the corpus checked in under `out/*/figures.json` the figure localization rate is reproducibly **60/61 ≈ 98.4%**. See [scholar-slides/README.md](./scholar-slides/README.md) for the full story.
  175. Design rationale and the 6-repo landscape survey behind this skill live in [docs/scholar-slides-design/](./docs/scholar-slides-design/).
  176. ---
  177. ## Lit Search Skill
  178. Retrieve **everything** published on a topic inside a time window, and be able to say *how much you missed*. Chat-style search returns "the top few by relevance" — not reproducible, and silent about its own gaps. This skill turns retrieval into a deterministic pipeline: **multi-source × full pagination × citation closure × a measurable saturation criterion**, then delivers the corpus.
  179. ### Features
  180. - **Recall is measured, not claimed** — gold-set recall, out-of-window leakage controls, per-source unique contribution, snowball saturation curve, PRISMA counts that *refuse to render* when they don't add up
  181. - **Says what it did NOT do** — sources declared but never contacted, unimplemented sources, skipped citation closure: each appears in `coverage_report.md` with a computed reason. "No gaps" is written out as a conclusion, never implied by a blank section
  182. - **Annotates quality, never filters** — CCF grade / journal metric / citation percentile decide *order*, not inclusion. A threshold would conflate "not evaluated" with "low quality" (measured: cutting at 4.0 dropped 340 papers that had *no metric at all*)
  183. - **Reaches closed publishers' metadata** — Elsevier 95.6% / Springer 80.4% / IEEE 98.7% abstract coverage via OpenAlex + PubMed. It does **not** bypass paywalls
  184. - **Human adjudication flows back in** — screening disagreements and boundary dates re-import with reviewer, timestamp, reason, and the prior verdict preserved
  185. - **Three depth tiers** with cost and wall-clock stated *before* you run (`lit depths`)
  186. ### Outputs
  187. `dois.md` (full DOI list, sectioned by quality tier, evidence per entry) · `references.md` (same order, GB/T 7714 / APA / IEEE / Nature / AMA) · `references.bib` (with `--bibtex`) · `PRISMA.md` · `coverage_report.md` · `human_queue.csv`
  188. ### Install & run
  189. ```bash
  190. cd ~/.claude/skills/lit-search && ./install.sh # uv sync + CLI smoke check
  191. uv run lit depths # scale, time and cost per tier
  192. ```
  193. Prereqs: **[uv](https://docs.astral.sh/uv/) + Python 3.11+.** **No API key needed to start** — screening can run on the host Claude Code (`lit screen --model host`). For 10k+ record runs, point it at any OpenAI-compatible endpoint instead.
  194. Keep run artifacts out of the skill folder — always pass `--runs-root /your/project/runs`; a systematic run reaches hundreds of MB.
  195. ### Not bundled, on purpose
  196. Journal ranking data (JCR quartiles, 中科院分区) is commercially licensed and the CCF catalogue is copyrighted — supply your own via `--ccf`. Without a catalogue the tool marks conferences "unrated" rather than guessing a grade: **a fabricated CCF-A looks exactly like a real one.**
  197. ---
  198. ## License
  199. MIT License

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.