$npx -y skills add Yuan1z0825/nature-skills --skill nature-paper2pptBuild a complete Nature-style Chinese PPTX presentation from a scientific paper, preprint, PDF, article text, figure legends, or reading notes. Use for journal club, group meeting, thesis seminar, paper sharing, conference or defense decks, and Chinese requests such as 论文做PPT、论文汇
| 1 | # Paper-to-PPTX — Router |
| 2 | |
| 3 | This skill is split into two layers: |
| 4 | |
| 5 | - A **static layer** under `static/` that holds versioned, reusable content fragments (core principles, toolchain policy, the 9-step workflow, output/quality rules, and per-paper-type presentation arcs). |
| 6 | - A **dynamic layer** (this file plus `manifest.yaml`) that detects the paper type and loads only the fragments needed for the current job. Deep design, figure, and self-review material lives in on-demand references. |
| 7 | |
| 8 | Do not try to apply the deck-building logic from memory or from this router. Always load fragments from disk as described below. |
| 9 | |
| 10 | ## Routing protocol |
| 11 | |
| 12 | Follow these five steps every time the skill is invoked. |
| 13 | |
| 14 | ### 1. Load the manifest and the core layer |
| 15 | |
| 16 | Read [manifest.yaml](manifest.yaml). It declares the `paper_type` axis, the allowed values, and the file paths each value maps to. |
| 17 | |
| 18 | Also read every file listed under `always_load`. These hold the purpose and core principle, the lean operating mode and toolchain policy, the 9-step workflow spine, and the output/quality rules that apply to every deck, plus the shared Terminology Ledger used to keep technical terms consistent across slides. |
| 19 | |
| 20 | ### 2. Classify the paper type |
| 21 | |
| 22 | Decide the `paper_type` value using the manifest's `detect:` hint and the source: |
| 23 | |
| 24 | - `discovery` — discovery / mechanism papers (question-to-evidence arc). Default. |
| 25 | - `methods` — methods / AI / tool / algorithm papers (problem-to-solution arc). |
| 26 | - `resource` — resource / dataset / atlas / omics / benchmark papers (workflow-to-validation arc). |
| 27 | - `clinical` — clinical / population / intervention studies (design-to-inference arc). |
| 28 | - `materials` — materials / chemistry / physics / engineering papers (property-to-mechanism / design-to-performance arc). |
| 29 | - `review` — reviews / perspectives / commentaries / meta-analyses (evidence-map arc). |
| 30 | |
| 31 | State the detected value in one short line to the user before designing slides, so they can correct you cheaply. |
| 32 | |
| 33 | ### 3. Load the matching fragment |
| 34 | |
| 35 | Read the file mapped for the detected `paper_type`. It gives the presentation arc and how to adapt the default slide structure for this type. Do **not** read every fragment in `static/`. |
| 36 | |
| 37 | ### 4. Build the deck using the loaded material |
| 38 | |
| 39 | Apply the loaded fragments in this priority order: |
| 40 | |
| 41 | 1. Core principles (`core/principles.md`) — the argument is the spine; lean operating mode; accepted inputs; Chinese-by-default language rule. |
| 42 | 2. Toolchain policy and fast path (`core/toolchain.md`) — cross-platform Python-first stack, default fast path. |
| 43 | 3. Paper-type arc (the loaded `paper_type` fragment) — narrative order and slide structure for this paper. |
| 44 | 4. Workflow (`core/workflow.md`) — run the 9 steps end to end. |
| 45 | 5. Output and quality rules (`core/output-and-quality.md`) — deliverables, quality gates, fallbacks. |
| 46 | |
| 47 | Build the Terminology Ledger (`../nature-shared/core/terminology-ledger.md`) while reading the source, so model names, gene/protein names, datasets, metrics, and abbreviations stay identical across every slide and speaker note. |
| 48 | |
| 49 | The end product is a real `.pptx` deck, not an outline or script. Do not fabricate results, numbers, or figure details. |
| 50 | |
| 51 | ### 5. Reach for references only when needed |
| 52 | |
| 53 | The files under `references/` are deep references, not defaults. Open them on demand per the `references.on_demand` table in the manifest: |
| 54 | |
| 55 | - composing/auditing slide layout, visual rhythm, typography, anti-template design, archetypes, on-slide text budget → `references/design-and-layout.md`. |
| 56 | - selecting, extracting, cropping, and quality-checking figure/table assets → `references/figure-assets.md`. |
| 57 | - running the self-review/corrective revision loop, severity grading, programmatic PPTX checks, rendered-preview policy, and final verification → `references/self-review.md`. |
| 58 | |
| 59 | When a real PPTX has been generated, run `scripts/audit_pptx_quality.py` unless the file is unavailable. Treat high-severity findings as blockers, revise the deck, then re-run the audit and record the final result in `output/qa_report.md`. |
| 60 | |
| 61 | ## Why this split |
| 62 | |
| 63 | - The static layer is versioned and reviewable. Adding a new paper-type arc is one new fragment plus one manifest line. |
| 64 | - The dynamic layer keeps each invocation che |