shzhao27208/aut_sci-html/aut-sci-html

Aut_Sci-Html

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

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:

python scripts/generate_html_deck.py paper paper.pdf -o 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 now 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.

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.