Agent skill

Sci HTML

by ShZhao27208 in ShZhao27208/Aut_Sci_Write

Generate academic presentation-style HTML slide decks and browser reports from PDFs, structured text, Markdown, paper summaries, outlines, or research notes.

MITAuto-check: notesDocuments & Office

Install Sci HTML

skills CLI
$ npx skills add ShZhao27208/Aut_Sci_Write --skill sci-html -a claude-code

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

GitHub CLI
$ gh skill install ShZhao27208/Aut_Sci_Write sci-html --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/ShZhao27208/Aut_Sci_Write.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/sci-html .claude/skills/sci-html && 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
sci-html
GitHub stars
209
Token cost
~1.4k tokens
SKILL.md length
600 words
Files
37 (incl. scripts)
Skills in repo
9
Repo updated
First seen
Licence
MIT

At a glance

Generate academic presentation-style HTML slide decks and browser reports from PDFs, structured text, Markdown, paper summaries, outlines, or research notes.

  • Works in 5 steps: Parse the user's source content into a… → Add cover, table of contents, section,… → Validate image paths and slide structure. → …
  • The user wants to convert a scientific paper PDF directly into an interactive HTML report
  • SKILL.md covers When To Use, Output, Workflow and PDF Paper Workflow, plus 4 more sections
  • Runs Python scripts from its folder; calls python

What it does

Sci HTML is an agent skill from ShZhao27208/Aut_Sci_Write. Generate academic presentation-style HTML slide decks and browser reports from PDFs, structured text, Markdown, paper summaries, outlines, or research notes. Use whenever the user wants to convert a scientific paper PDF directly into an interactive HTML report, clickable web presentation, shareable browser deck, or PPT-like HTML output with figures, structured insights, section pages, and offline deck-directory output. In the AutSciWrite suite, choose this skill when the user wants HTML/web output; choose sci-ppt…

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 41 other files, including scripts (for example `README.md`, `THIRD_PARTY_NOTICES.md` and `_meta.json`).

It sits in Documents & Office, covering Slides and decks, HTML artifacts and PowerPoint presentations. It works with Microsoft PowerPoint. The repository describes itself as: Academic research skills suite for AI Agent — literature search/download (WoS+Elsevier+Springer), PDF extraction, figure cropping, review writing, Zotero sync, and PPT/Html… The licence is MIT.

When your agent uses it

  • The user wants to convert a scientific paper PDF directly into an interactive HTML report
  • Clickable web presentation
  • Shareable browser deck
  • PPT-like HTML output with figures

Example prompts

  • “/sci-html”

Requirements

  • Python 3

Workflow steps

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

  1. Parse the user's source content into a deck model.
  2. Add cover, table of contents, section, summary, and ending slides when appropriate.
  3. Validate image paths and slide structure.
  4. Render HTML, CSS, and JS.
  5. Tell the user the output path and navigation controls.

What it can do on your machine

Read from SKILL.md and the folder at commit 357766f. 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/ (Python, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    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

Sci HTML loads about 1.4k tokens when it runs. Until then it costs about 142 tokens; SKILL.md has 600 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~142
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:86
    ML by default. Do not write API keys or `.env` values into generated decks.
  • NoteMentions a .env fileSKILL.md:93
    - Do not create or require skill-local `.env` files for this skill; it runs offline except for optional dependencies ins

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 ShZhao27208/Aut_Sci_Write at commit 357766f, republished under its MIT licence (© ShZhao27208). 600 words, ~1,418 tokens.

Download SKILL.mdSave it as .claude/skills/sci-html/SKILL.md (or your agent's skills folder). This skill also uses 36 other files; get the full folder from GitHub.
name
sci-html
description
Generate academic presentation-style HTML slide decks and browser reports from PDFs, structured text, Markdown, paper summaries, outlines, or research notes. Use whenever the user wants to convert a scientific paper PDF directly into an interactive HTML report, clickable web presentation, shareable browser deck, or PPT-like HTML output with figures, structured insights, section pages, and offline deck-directory output. In the Aut_Sci_Write suite, choose this skill when the user wants HTML/web output; choose sci-ppt when they explicitly need a .pptx file.
author
Shuo Zhao
license
MIT
copyright
Copyright (c) 2026 Shuo Zhao. All rights reserved.
triggers
html slides, HTML report, paper to html, browser presentation, interactive paper report, web presentation, clickable slides, academic HTML, Markdown to HTML…

Sci HTML

Use this skill to create browser-based academic slide decks inside the Aut_Sci_Write suite. It can work from prepared Markdown/JSON, or run the full paper workflow from PDF to structured insights, extracted figures, and HTML deck.

Use sci-html for shareable browser output. Use sci-ppt when the user needs a real .pptx. Use sci-extract when the user only wants a text analysis without a presentation artifact.

When To Use

Use this skill when the user asks for HTML slides, clickable presentation webpages, browser-based academic presentations, Markdown to slide deck, paper summary to web presentation, PDF paper to HTML report, or a PPT-like HTML file with left/right navigation.

Output

Always create a deck directory containing index.html, deck.json, assets/style.css, assets/deck.js, and copied local figures under assets/figures/.

Do not create single-file HTML. Directory output is the standard mode because it keeps the presentation maintainable and avoids oversized embedded assets.

Workflow

  1. Parse the user's source content into a deck model.
  2. Add cover, table of contents, section, summary, and ending slides when appropriate.
  3. Validate image paths and slide structure.
  4. Render HTML, CSS, and JS.
  5. Tell the user the output path and navigation controls.

PDF Paper Workflow

For a source PDF, use the integrated paper command rather than requiring separate sci-extract or sci-figure skills:

bash
python scripts/generate_html_deck.py paper paper.pdf -o out/paper-report --author "Presenter"

When working from the Aut_Sci_Write repository root, run:

bash
python skills/sci-html/scripts/generate_html_deck.py paper paper.pdf -o skills/sci-html/out/paper-report --author "Presenter"

This writes structured_insights.json, figure_manifest.json, extracted files under figures/, a generated {paper-stem}-deck.md, and the final index.html.

The PDF workflow uses bundled integrations copied from sci-extract and sci-figure. It requires PyMuPDF, pdfplumber, numpy, opencv-python, Pillow, and pytesseract; Tesseract OCR is optional and only affects subfigure OCR.

The integrated sci-extract logic detects original research versus review literature. Original research decks emphasize problem, method, results, innovation, applications, and limits. Review, survey, systematic review, scoping review, and meta-analysis decks emphasize scope, taxonomy, evidence base, consensus, controversies, evidence quality, research gaps, future directions, and important figures or tables. Use --paper-type auto|research|review when the user wants to override automatic routing.

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

Presentation Markup

  • Put layout: section at the top of a Markdown slide block to create a chapter divider.
  • Put subtitle: 01 below layout: section to show the chapter number.
  • Use **key phrase** or ==key phrase== for red emphasis.
  • Keep bullets concise; generated bullet slides use numbered key-point cards by default.
  • When a slide has only one or two content bullets, render it as plain statements without visible item numbers.
  • Long slide and paper titles are automatically fitted by shrinking the heading and expanding its line width so the title stays on the page.
  • Sparse slides automatically receive subtle topic motifs from title and bullet keywords, so visually empty areas are filled without requiring extra image assets.

Navigation Controls

Generated decks support mouse click, left-third click for previous slide, explicit Prev/Next buttons, left/right arrow keys, space, Home/End, F fullscreen, and URL hash state such as #/3.

Design Rules

Keep slides academic, readable, and presentation-oriented. Avoid long paragraphs. Prefer figures, concise numbered points, section breaks, and strong hierarchy. Use decorative but unobtrusive visual patterns to reduce empty space. Keep section and ending slides centered. Escape user-provided HTML by default. Do not write API keys or .env values into generated decks.

Aut_Sci_Write Integration

  • sci-html is one of the suite's output skills alongside sci-ppt.
  • The paper workflow locally reuses Aut_Sci_Write extraction and figure-processing logic, so users do not need to manually chain sci-extract and sci-figure before generating a deck.
  • Keep generated decks under out/ or another user-selected output folder. These outputs are intentionally ignored by the repository/package rules.
  • Do not create or require skill-local .env files for this skill; it runs offline except for optional dependencies installed by the user.

© ShZhao27208, 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 36 other files (scripts) in skills/sci-html of ShZhao27208/Aut_Sci_Write.

  • SKILL.md
  • .gitignore
  • LICENSE
  • README.md
  • THIRD_PARTY_NOTICES.md
  • _meta.json
  • archives/.keep
  • conftest.py
  • examples/sample_outline.md
  • examples/sample_slides.md
  • examples/uconversion_review.md
  • pyproject.toml
  • requirements.txt
  • scripts/generate_html_deck.py
  • src/sci_html/__init__.py
  • src/sci_html/cli.py
  • … and 21 more

Open the folder on GitHubat commit 357766f

Compare with similar skills

Sci HTML 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.

Sci HTML compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sci HTML this skillShZhao27208/Aut_Sci_Write209—~1.4kAutomated safety check: NotesMIT
Ky Markdown RebuilderKyrieCheungYep/ky-markdown-rebuilder117—~5.7kAutomated safety check: PassNone
Paper2slidesQuZhan51496/paper2anything469—~3.8kAutomated safety check: NotesApache-2.0
Academic WritingZimoLiao/scholaraio577—~827Automated safety check: PassMIT
Nature Paper2pptjing1312/nature-figure-skill168—~9.5kAutomated safety check: PassMIT
Nature Paper2pptCitrus-bit/Anaxa1201 repos~5.9kAutomated safety check: PassMIT

Similar skills

  • Ky Markdown Rebuilder

    KyrieCheungYep/ky-markdown-rebuilder

    Rebuild visual documents into reliable Markdown by combining text extraction with page or screenshot alignment.

    117 GitHub stars~5.7k tokensUpdated 3 mo ago
    Documents & OfficeAuto-check passed
  • Paper2slides

    QuZhan51496/paper2anything

    Turn an academic paper PDF into a presentation deck (.pptx) end-to-end.

    469 GitHub stars~3.8k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check: notes
  • Academic Writing

    ZimoLiao/scholaraio

    A skill your agent uses when the user needs help choosing or organizing an academic-writing workflow by deliverable, stage, or format, including review articles, guided reading, paper sections, PPT…

    577 GitHub stars~827 tokensUpdated 13 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.

    168 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
  • Journal Club Ppt

    xuzhougeng/wisp-science

    A skill your agent uses whenever the user provides a scientific paper PDF and asks for a group-meeting literature report, journal-club slides, 文献汇报PPT, 组会PPT, paper presentation, article…

    1k GitHub stars~3.6k tokensUpdated today
    Documents & OfficeAuto-check passed

More from ShZhao27208/Aut_Sci_Write

All 9 skills in this repo
  • Sci Polish

    ShZhao27208/Aut_Sci_Write

    Two-stage academic paper polishing skill. An agent skill from ShZhao27208/Aut_Sci_Write.

    209 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Sci Review

    ShZhao27208/Aut_Sci_Write

    Specialized workflows for drafting, refining, and responding to academic literature reviews and peer review feedback.

    209 GitHub stars~673 tokensUpdated 1 mo ago
    Auto-check passed
  • Sci Figure

    ShZhao27208/Aut_Sci_Write

    Extracts figures and sub-figures from academic PDF papers. An agent skill from ShZhao27208/Aut_Sci_Write.

    209 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Sci Ppt

    ShZhao27208/Aut_Sci_Write

    Generate professional academic PowerPoint (PPTX) presentations from paper PDFs, structured outlines, or plain text.

    209 GitHub stars~757 tokensUpdated 1 mo ago
    Auto-check passed
  • Sci Search

    ShZhao27208/Aut_Sci_Write

    Academic paper search and metrics analysis. An agent skill from ShZhao27208/Aut_Sci_Write.

    209 GitHub stars~1.7k tokensUpdated 1 mo ago
    Auto-check: notes
  • Sci Extract

    ShZhao27208/Aut_Sci_Write

    Read an academic paper end to end and extract professional research insights, figures, metadata, and critique.

    209 GitHub stars~5.8k tokensUpdated 1 mo ago
    Auto-check: notes

Questions about Sci HTML

What does Sci HTML do?

Generate academic presentation-style HTML slide decks and browser reports from PDFs, structured text, Markdown, paper summaries, outlines, or research notes. Sci HTML is an agent skill from ShZhao27208/Aut_Sci_Write. Generate academic presentation-style HTML slide decks and browser reports from PDFs, structured text, Markdown, paper summaries, outlines, or research notes.

When should I use Sci HTML?

Sci HTML fits situations like: the user wants to convert a scientific paper PDF directly into an interactive HTML report; clickable web presentation; shareable browser deck; PPT-like HTML output with figures.

How do I install Sci HTML in Claude Code?

Run `npx skills add ShZhao27208/Aut_Sci_Write --skill sci-html -a claude-code`. Or copy the skill folder (skills/sci-html in ShZhao27208/Aut_Sci_Write) into .claude/skills/sci-html in your project. Claude Code loads it when a task matches its description.

How do I install Sci HTML in Codex?

Run `npx skills add ShZhao27208/Aut_Sci_Write --skill sci-html -a codex`. Or copy the skill folder (skills/sci-html in ShZhao27208/Aut_Sci_Write) into .agents/skills/sci-html in your project. Codex loads it when a task matches its description.

Can I use Sci HTML 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 ShZhao27208/Aut_Sci_Write --skill sci-html -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sci-html, .gemini/skills/sci-html, .github/skills/sci-html and .opencode/skills/sci-html in your project.

What does Sci HTML need to run?

Going by SKILL.md and its folder, Sci HTML needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Sci HTML 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 Sci HTML safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. 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 Sci HTML use?

Sci HTML is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sci HTML use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Sci HTML?

Skills that share tags, products or a category with Sci HTML: Ky Markdown Rebuilder (KyrieCheungYep/ky-markdown-rebuilder, 117 stars), Paper2slides (QuZhan51496/paper2anything, 469 stars), Academic Writing (ZimoLiao/scholaraio, 577 stars) and Nature Paper2ppt (jing1312/nature-figure-skill, 168 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sci HTML?

ShZhao27208 (a GitHub user) maintains it in ShZhao27208/Aut_Sci_Write, which has 209 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on August 13, 2026.

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