Agent skill

Academic Slide Pragmatic Fallback

by fangyuanopus in fangyuanopus/literature-report-ppt-builder

Create Chinese academic literature-report PPTs from real paper/SI figures.

MITAuto-check passedDocuments & Office

Install Academic Slide Pragmatic Fallback

skills CLI
$ npx skills add fangyuanopus/literature-report-ppt-builder --skill academic-slide-pragmatic-fallback -a claude-code

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

GitHub CLI
$ gh skill install fangyuanopus/literature-report-ppt-builder academic-slide-pragmatic-fallback --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/fangyuanopus/literature-report-ppt-builder.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/academic-slide-pragmatic-fallback .claude/skills/academic-slide-pragmatic-fallback && 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
academic-slide-pragmatic-fallback
GitHub stars
110
Token cost
~1.7k tokens
SKILL.md length
661 words
Files
70 (incl. scripts, references, assets)
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Create Chinese academic literature-report PPTs from real paper/SI figures.

  • Works in 6 steps: Confirm paper/SI source availability and… → Create paper_analysis.json following… → Derive the terminology table,… → …
  • Slide-review tasks
  • SKILL.md covers Non-negotiable rules, Choose one route, Page ownership and fit contract and Required production flow, plus 1 more section
  • Especially when Image2-style full-slide generation is unavailable

What it does

Academic Slide Pragmatic Fallback is an agent skill from fangyuanopus/literature-report-ppt-builder. Create Chinese academic literature-report PPTs from real paper/SI figures. Use for journal-club, thesis-defense, paper-to-PPT, and slide-review tasks, especially when Image2-style full-slide generation is unavailable. Preserve the strict Image2-only route when available; otherwise require explicit consent and choose a clean template-fidelity or a sample-style pragmatic fallback with real figures, source tracking, structural QA, and render QA.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 72 other files, including scripts, reference files and assets (for example `agents/openai.yaml`, `references/adaptive-navigation.md` and `references/annotation-language.md`).

It sits in Documents & Office, covering Slides and decks, PowerPoint presentations and Essays and academic help. It works with Microsoft PowerPoint. The repository describes itself as: Open-source Codex skill for academic literature-report PPT generation. The licence is MIT.

When your agent uses it

  • Slide-review tasks
  • Especially when Image2-style full-slide generation is unavailable

Example prompts

  • “/academic-slide-pragmatic-fallback”

Requirements

  • Python 3

Workflow steps

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

  1. Confirm paper/SI source availability and explicit fallback consent.
  2. Create paper_analysis.json following references/paper-analysis-contract.md, then run scripts/validate_paper_analysis.py --fail-on-review…
  3. Derive the terminology table, figure-source manifest, deck_order_map.md, and page briefs from the validated analysis. Do not introduce a…
  4. Choose Route A, B, or C and prepare page briefs with source crops and page types.
  5. Build only through that route; do not silently substitute a different route.
  6. Run structural QA, render every slide with PowerPoint/LibreOffice where available, inspect individual pages and a montage, and fix all…

What it can do on your machine

Read from SKILL.md and the folder at commit 6d52894. 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.

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

  • Network

    No URLs in SKILL.md.

    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

Academic Slide Pragmatic Fallback loads about 1.7k tokens when it runs, and up to ~99k if it reads all its reference files. Until then it costs about 120 tokens; SKILL.md has 661 words of instructions outside code blocks.

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

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 fangyuanopus/literature-report-ppt-builder at commit 6d52894, republished under its MIT licence (© fangyuanopus). 661 words, ~1,659 tokens.

Download SKILL.mdSave it as .claude/skills/academic-slide-pragmatic-fallback/SKILL.md (or your agent's skills folder). This skill also uses 69 other files; get the full folder from GitHub.
name
academic-slide-pragmatic-fallback
description
Create Chinese academic literature-report PPTs from real paper/SI figures. Use for journal-club, thesis-defense, paper-to-PPT, and slide-review tasks, especially when Image2-style full-slide generation is unavailable. Preserve the strict Image2-only route when available; otherwise require explicit consent and choose a clean template-fidelity or a sample-style pragmatic fallback with real figures, source tracking, structural QA, and render QA.

Academic Slides with Safe Fallbacks

Create academic decks that are evidence-led, readable, and honest about their production route.

Non-negotiable rules

  • Use scientific visuals only from the paper, SI, or user-provided sources. Never fabricate, redraw, or semantically alter data figures, microscopy, spectra, molecular structures, mechanisms, tables, or charts.
  • Write conclusion-style titles, trace every visual in a figure-source manifest, and calibrate claims to evidence.
  • Do not call an editable or code-built deck Image2-only.

Choose one route

Route A: Image2-only authoritative deck

Use only when a full-slide Image2 backend is confirmed and can faithfully preserve supplied scientific crops. Keep image2_manifest.json, package one approved full-slide image per PPTX slide, and run scripts/validate_image_only_pptx.py.

Route B: template-fidelity fallback

Use only after explicit user consent and a passed hygiene audit. The template owns its navigation, footer, and mapped slots; code edits inherited objects in place and must not add a second navigation layer.

When the user explicitly asks to reproduce the bundled sample template exactly, use Route B's exact-template mode. Preserve the sample's navigation labels and decorative chrome intentionally, map each output page to a distinct source-slide archetype, and replace or remove every source-specific scientific object. Do not describe a code-redrawn Route C deck as an exact reproduction. Read references/exact-template-fidelity.md before building.

text
python scripts/build_fallback_template_pptx.py edit_plan.json exact.pptx --strict --fail-on-warnings
python scripts/audit_fallback_template_pptx.py exact.pptx --build-report exact.build-report.json --check-masters --exact-template --fail-on-review
python scripts/audit_exact_template_fidelity.py exact.pptx --plan edit_plan.json --build-report exact.build-report.json --fail-on-review
text
python scripts/audit_fallback_template_pptx.py template.pptx --check-masters --fail-on-review

Reject templates containing old scientific content, figure labels, sample names, or non-removable master/layout objects. For adaptive cross-domain reuse, also reject fixed legacy navigation. The only exception is exact-template mode, where the user has explicitly requested that navigation and it remains semantically appropriate. Read references/template-hygiene.md and references/fallback-template-pptx.md.

Route C: pragmatic fallback

Use only after explicit user consent when Image2 is unavailable and no clean, domain-compatible template passes Route B. Start from a blank 16:9 presentation: code owns every visible object. Never import a content-bearing master or layout.

Route C follows the visual grammar of assets/sample-literature-report.pptx—white canvas, red-black-gray palette, shallow top navigation, conclusion title, thin rule, and quiet footer/page number—without inheriting the sample's old content. Read references/first-template-style-contract.md and references/pragmatic-fallback.md.

Every page brief must specify one of: cover, text, figure_right, figure_wide, process, comparison, summary, or closing.

text
python scripts/build_pragmatic_fallback_pptx.py pragmatic_edit_plan.json --out editable_fallback_presentation.pptx
python scripts/validate_pragmatic_fallback_pptx.py editable_fallback_presentation.pptx --plan pragmatic_edit_plan.json --fail-on-review

Every displayed scientific figure requires source_type: figure_crop, crop_verified: true, figure ID, source page, and source label. A full paper-page scan is not a figure crop.

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

Page ownership and fit contract

  • Choose exactly one owner per slide: inherited template objects in Route B, or generated objects in Route C. Never combine the two.
  • The builder treats every code-owned text box as a fixed template slot: it blocks copy that exceeds the slot's CJK-aware line capacity, as well as titles over 54 characters and overlong bullet lists. Shorten or restructure copy before building; never shrink one page's font or truncate with ellipses.
  • Select the layout from the evidence: use wide figures for plots/tables, right-side figures for portrait images, process flow for 2–5 steps, comparison for two alternatives, and summary rows for 2–5 conclusions/parameters.
  • Do not expose internal route names, template notes, model names, fallback labels, or build instructions in audience-facing slides.

Required production flow

  1. Confirm paper/SI source availability and explicit fallback consent.
  2. Create paper_analysis.json following references/paper-analysis-contract.md, then run scripts/validate_paper_analysis.py --fail-on-review. This is the source of truth for the logic tree, figure boundaries, evidence chains, adaptive navigation, and slide claims.
  3. Derive the terminology table, figure-source manifest, deck_order_map.md, and page briefs from the validated analysis. Do not introduce a slide claim, source figure, or navigation section that is absent from the analysis without updating and revalidating it.
  4. Choose Route A, B, or C and prepare page briefs with source crops and page types.
  5. Build only through that route; do not silently substitute a different route.
  6. Run structural QA, render every slide with PowerPoint/LibreOffice where available, inspect individual pages and a montage, and fix all overflow, overlap, legacy residue, unreadable figures, and inconsistent chrome.

For exact-template mode, also compare the montage with the source-template montage. Passing structural QA alone is insufficient: the inherited navigation, title treatment, margins, footer band, image framing, and whitespace rhythm must remain visibly unchanged.

Route C delivery statement

text
Image2 backend used: no
Delivery mode: pragmatic editable fallback accepted by user
Visual style: sample-deck-derived white/red/black academic grammar
Scientific visuals: real paper/SI/user-provided figure crops only
Structural QA completed: yes
Render/layout QA completed: yes/no
Editable elements may exist: yes

© fangyuanopus, 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 69 other files (scripts, references, assets) in skills/academic-slide-pragmatic-fallback of fangyuanopus/literature-report-ppt-builder.

  • SKILL.md
  • agents/openai.yaml
  • assets/icon.svg
  • assets/sample-literature-report.pptx
  • references/adaptive-navigation.md
  • references/annotation-language.md
  • references/backup-slides.md
  • references/batch-image-consistency.md
  • references/close-reading-rules.md
  • references/deck-diagnosis-mode.md
  • references/deck-order-map.md
  • references/delivery-package.md
  • references/domain-adaptation.md
  • references/editable-output-options.md
  • references/evidence-strength.md
  • references/exact-template-fidelity.md
  • references/failure-recovery.md
  • references/fallback-template-edit-spec.md
  • … and 52 more

Open the folder on GitHubat commit 6d52894

Compare with similar skills

Academic Slide Pragmatic Fallback 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.

Academic Slide Pragmatic Fallback compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Academic Slide Pragmatic Fallback this skillfangyuanopus/literature-report-ppt-builder110—~1.7kAutomated safety check: PassMIT
EasyslidesRimagination/easyslides138—~12kAutomated safety check: PassMIT
Nature Paper2pptjing1312/nature-figure-skill171—~9.5kAutomated safety check: PassMIT
Nature Paper2pptCitrus-bit/Anaxa1201 repos~5.9kAutomated safety check: PassMIT
Nature Paper2pptTai609/NebulaMat100—~1.3kAutomated safety check: PassCustom licence
Ppt Visual ReplicaZhiweiWei-NAMI/PPT-Visual-Replica135—~1.8kAutomated safety check: PassMIT

Similar skills

  • Easyslides

    Rimagination/easyslides

    Use EasySlides to create, distill, edit, review, and export editable academic PPTX presentations, including 蒸馏PPT、提取模板、复用模板和答辩PPT。

    138 GitHub stars~12k tokensUpdated 28 days ago
    Documents & OfficeAuto-check passed
  • Nature Paper2ppt

    jing1312/nature-figure-skill

    Build a complete but efficient Nature-style Chinese PPTX presentation from a scientific paper, preprint, PDF, article text, abstract, figure legends, or reading notes.

    171 GitHub stars~9.5k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Nature Paper2ppt

    Citrus-bit/Anaxa

    Build a complete but efficient Nature-style Chinese PPTX presentation from a scientific paper, preprint, PDF, article text, abstract, figure legends, or reading notes.

    120 GitHub starsUsed in 1 repo~5.9k tokens
    Documents & OfficeAuto-check passed
  • Nature Paper2ppt

    Tai609/NebulaMat

    Build a complete Nature-style Chinese PPTX presentation from a scientific paper, preprint, PDF, article text, figure legends, or reading notes.

    100 GitHub stars~1.3k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Ppt Visual Replica

    ZhiweiWei-NAMI/PPT-Visual-Replica

    Create and edit editable PowerPoint decks, recreate slides or infographics from reference images, and develop scientific talks, teaching slides, and thesis defenses by generating slide drafts with…

    135 GitHub stars~1.8k tokensUpdated 25 days ago
    Documents & OfficeAuto-check passed
  • Research Presentation

    Yila-AI/awesome-research-skills

    Create, revise, and quality-check source-grounded research presentations from papers, research notes, data, or manuscripts.

    133 GitHub stars~2.5k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed

More from fangyuanopus/literature-report-ppt-builder

  • Academic Slide Minimalist

    fangyuanopus/literature-report-ppt-builder

    A skill your agent uses for Chinese academic literature-report PPTs, research slides, journal-club decks, thesis-defense slides, slide page images, or paper-to-PPT workflows based on real paper/SI…

    110 GitHub stars~11k tokensUpdated 3 mo ago
    Auto-check passed

Questions about Academic Slide Pragmatic Fallback

What does Academic Slide Pragmatic Fallback do?

Create Chinese academic literature-report PPTs from real paper/SI figures. Academic Slide Pragmatic Fallback is an agent skill from fangyuanopus/literature-report-ppt-builder. Create Chinese academic literature-report PPTs from real paper/SI figures.

When should I use Academic Slide Pragmatic Fallback?

Academic Slide Pragmatic Fallback fits situations like: slide-review tasks; especially when Image2-style full-slide generation is unavailable.

How do I install Academic Slide Pragmatic Fallback in Claude Code?

Run `npx skills add fangyuanopus/literature-report-ppt-builder --skill academic-slide-pragmatic-fallback -a claude-code`. Or copy the skill folder (skills/academic-slide-pragmatic-fallback in fangyuanopus/literature-report-ppt-builder) into .claude/skills/academic-slide-pragmatic-fallback in your project. Claude Code loads it when a task matches its description.

How do I install Academic Slide Pragmatic Fallback in Codex?

Run `npx skills add fangyuanopus/literature-report-ppt-builder --skill academic-slide-pragmatic-fallback -a codex`. Or copy the skill folder (skills/academic-slide-pragmatic-fallback in fangyuanopus/literature-report-ppt-builder) into .agents/skills/academic-slide-pragmatic-fallback in your project. Codex loads it when a task matches its description.

Can I use Academic Slide Pragmatic Fallback 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 fangyuanopus/literature-report-ppt-builder --skill academic-slide-pragmatic-fallback -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/academic-slide-pragmatic-fallback, .gemini/skills/academic-slide-pragmatic-fallback, .github/skills/academic-slide-pragmatic-fallback and .opencode/skills/academic-slide-pragmatic-fallback in your project.

What does Academic Slide Pragmatic Fallback need to run?

SKILL.md names no scripts, command-line tools or credentials: Academic Slide Pragmatic Fallback is instructions for the agent only. Our summary lists: Python 3.

Does Academic Slide Pragmatic Fallback access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Academic Slide Pragmatic Fallback 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 Academic Slide Pragmatic Fallback use?

Academic Slide Pragmatic Fallback is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Academic Slide Pragmatic Fallback use?

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

What are the alternatives to Academic Slide Pragmatic Fallback?

Skills that share tags, products or a category with Academic Slide Pragmatic Fallback: Easyslides (Rimagination/easyslides, 138 stars), Nature Paper2ppt (jing1312/nature-figure-skill, 171 stars), Nature Paper2ppt (Citrus-bit/Anaxa, 120 stars) and Nature Paper2ppt (Tai609/NebulaMat, 100 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Academic Slide Pragmatic Fallback?

fangyuanopus (a GitHub user) maintains it in fangyuanopus/literature-report-ppt-builder, which has 110 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on July 11, 2026.

Source: fangyuanopus/literature-report-ppt-builder on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.