Agent skill

Quarto Deck

by flonat in flonat/flonat-research

Generate a Reveal.js HTML presentation from Markdown. An agent skill from flonat/flonat-research.

MITAuto-check passedDocuments & Office

Install Quarto Deck

skills CLI
$ npx skills add flonat/flonat-research --skill quarto-deck -a claude-code

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

GitHub CLI
$ gh skill install flonat/flonat-research quarto-deck --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/flonat/flonat-research.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/quarto-deck .claude/skills/quarto-deck && 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
quarto-deck
GitHub stars
145
Token cost
~2.2k tokens
SKILL.md length
834 words
Files
3 (incl. references)
Skills in repo
83
Repo updated
First seen
Licence
MIT

At a glance

Generate a Reveal.js HTML presentation from Markdown. An agent skill from flonat/flonat-research.

  • Works in 6 steps: Gather Context (Direct) → Design Structure (Direct) → Build Deck (Direct) → …
  • The user asks to generate a Reveal.js HTML presentation from Markdown
  • SKILL.md covers Purpose, When to Use, Prerequisites and Critical Rules, plus 7 more sections
  • Calls uv and npm

What it does

Quarto Deck is an agent skill from flonat/flonat-research. Generate a Reveal.js HTML presentation from Markdown. Use when the user asks to generate a Reveal.js HTML presentation from Markdown.

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/markdown-format.md` and `references/quality-rubric.md`).

It sits in Documents & Office, covering Slides and decks and Markdown. It works with Python. The repository describes itself as: Shareable Claude Code + Codex infrastructure for PhD researchers — skills, agents, hooks, and rules for academic workflows. The licence is MIT.

When your agent uses it

  • The user asks to generate a Reveal.js HTML presentation from Markdown
  • Tasks that involve Slides and decks
  • Tasks that involve Markdown

Example prompts

  • “/quarto-deck”

Requirements

  • Python 3
  • Node.js
  • Pre-approved tools (allowed-tools): Bash(reveal-md*), Bash(npx*), Bash(mkdir*), Bash(ls*), Bash(cp*), Bash(open*), Bash(R*), Bash(Rscript*), Bash(uv:*), Read, Write, Edit, Task

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Gather Context (Direct)
  2. Design Structure (Direct)
  3. Build Deck (Direct)
  4. Preview and Fix (Direct)
  5. Rhetoric Review (Sub-Agent — Explore)
  6. Apply and Finalise (Direct)

What it can do on your machine

Read from SKILL.md and the folder at commit da27600. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(reveal-md*)
    • Bash(npx*)
    • Bash(mkdir*)
    • Bash(ls*)
    • Bash(cp*)
    • Bash(open*)
    • Bash(R*)
    • Bash(Rscript*)
    • Bash(uv:*)
    • Read

    …and 3 more on the same allowed-tools line.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv
    • npm

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

  • Network

    No URLs in SKILL.md. Its commands use uv and npm, which can reach the network depending on how they are called.

    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

Quarto Deck loads about 2.2k tokens when it runs, and up to ~3.3k if it reads all its reference files. Until then it costs about 36 tokens; SKILL.md has 834 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from flonat/flonat-research at commit da27600, republished under its MIT licence (© flonat). 834 words, ~2,176 tokens.

Download SKILL.mdSave it as .claude/skills/quarto-deck/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
quarto-deck
description
Generate a Reveal.js HTML presentation from Markdown. Use when the user asks to generate a Reveal.js HTML presentation from Markdown.
allowed-tools
Bash(reveal-md*), Bash(npx*), Bash(mkdir*), Bash(ls*), Bash(cp*), Bash(open*), Bash(R*), Bash(Rscript*), Bash(uv:*), Read, Write, Edit, Task
argument-hint
[topic, content-path, or project-name]
skill-dependencies
beamer-deck

Reveal.js Deck Skill

Generate HTML presentations from Markdown using reveal-md. Applies the same rhetoric framework as beamer-deck but outputs browser-native slides ideal for teaching, informal talks, and web sharing.

Purpose

Create polished Reveal.js presentations from Markdown files. Every deck gets assertion-driven titles, narrative arc, and rhetoric review. Output is an HTML presentation that runs in any browser — no LaTeX needed.

Use this for: Teaching, informal research talks, web-shareable presentations, interactive demos. Use beamer-deck for: Conference talks, formal seminars, supervisor meetings, anything that needs PDF-native output.

When to Use

  • Teaching lectures (undergraduate or PhD) — interactive, live in browser
  • Informal research presentations or lab meetings
  • Talks where you want to share a URL instead of a PDF
  • Presentations with live code demos or embedded content
  • Quick decks where LaTeX overhead isn't justified

Python: Always use uv run python. Never bare python, python3, pip, or pip3.

Prerequisites

  • reveal-md (installed globally): npm install -g reveal-md
  • Node.js 18+ (via nvm)

Critical Rules

  1. Python: ALWAYS use uv run python or uv pip install. Never use bare python, python3, pip, or pip3. Include this instruction in any sub-agent prompts that may run Python.
  2. One Markdown file = one presentation. All slides live in a single .md file with --- separators.
  3. Titles are assertions, not labels. "Distance increases abortion rates" — not "Results". Every slide title states a claim.
  4. One idea per slide. Not a guideline. A law. If a slide has two ideas, split it.
  5. Speaker notes use the Note: keyword. Place after slide content, before the next ---.
  6. Custom CSS goes in a separate file. Never inline styles in the Markdown.
  7. Figures first, slides second. Generate figures via R or Python scripts before referencing them.
  8. Test in browser before finalising. Run reveal-md <file>.md and check every slide.

Rhetoric Principles

Same framework as beamer-deck. Full reference (Three Laws, MB/MC, Aristotelian Triad, Narrative Arc, Pyramid Principle, Devil's Advocate, audience-specific guidance): ../shared/rhetoric-principles.md


Quality Scoring

Apply numeric quality scoring using the shared framework and skill-specific rubric:

Start at 100, deduct per issue found, apply verdict. Compute the score in Phase 6 and report it in the final output.

Reveal.js Markdown Format

Full format reference with basic structure, vertical slides, fragments, custom themes, and CSS examples: references/markdown-format.md

Reference palettes (Professional, Energetic, Academic) with both LaTeX and CSS variants: ../shared/palettes.md


Workflow: 6 Phases

You (orchestrator)
├── Phase 1: Gather context        (direct)
├── Phase 2: Design structure       (direct)
├── Phase 3: Build deck             (direct)
├── Phase 4: Preview & fix          (direct)
├── Phase 5: Rhetoric review        (sub-agent — Explore)
└── Phase 6: Apply & finalise       (direct)
Phase 1: Gather Context (Direct)

Read project files, content sources, and audience brief. Ask the user:

  • Audience: Teaching? Lab meeting? Informal talk?
  • Duration: How long?
  • Content source: Paper draft? Notes? Existing slides?
  • Special requirements: Code demos? Interactive elements? Specific theme?
  • Export needs: Browser only, or also need static HTML/PDF?
Phase 2: Design Structure (Direct)
  1. Choose rhetoric balance based on audience
  2. Outline slide sequence with assertion titles
  3. Plan narrative arc — identify Act I/II/III transitions
  4. Choose colour palette — create custom.css
  5. Identify figures needed — which need code generation?

Present outline to the user for approval.

Show full SKILL.md (338 more words)Show less
Phase 3: Build Deck (Direct)
  1. Generate figures first — R/Python scripts, save to figures/
  2. Write the .md file with YAML frontmatter and slide content
  3. Write custom.css if custom theming is needed
  4. Test locally: reveal-md deck.md
  5. Add speaker notes using Note: blocks
Phase 4: Preview and Fix (Direct)
  1. Run reveal-md deck.md to preview in browser
  2. Check every slide for:
    • Text overflow or cramped content
    • Figure sizing and alignment
    • Math rendering (MathJax)
    • Code highlighting
    • Transitions between slides
  3. Fix issues and re-preview
Phase 5: Rhetoric Review (Sub-Agent — Explore)

Launch the same rhetoric review as beamer-deck, adapted for Markdown:

subagent_type: Explore
prompt: |
  You are a rhetoric reviewer for an academic Reveal.js presentation.

  Read the file at: [PATH TO .md FILE]

  Evaluate against these criteria:

  ## 1. Narrative Arc
  - Three-act structure (Problem → Investigation → Resolution)?
  - Opening: provocative question, statistic, or bold claim?
  - Closing: single memorable takeaway?

  ## 2. MB/MC Balance
  - Cognitive load distributed smoothly?
  - Overloaded or underloaded slides?

  ## 3. Title Quality
  - Every title an assertion (a claim), not a label?

  ## 4. One Idea Per Slide
  - Any slide trying to convey multiple ideas?

  ## 5. Transitions
  - Are transitions between slides explicit?
  - Does the audience know where they are in the argument?

  ## 6. Pyramid Principle
  - Conclusions before support?

  Return structured markdown with ratings and specific slide suggestions.
Phase 6: Apply and Finalise (Direct)
  1. Incorporate rhetoric review feedback
  2. Re-preview in browser
  3. Compute quality score — read references/quality-rubric.md, log all issues from Phases 4-5, compute score and verdict
  4. Export if needed:
    • Static HTML: reveal-md deck.md --static _site
    • PDF: reveal-md deck.md --print deck.pdf
  5. Confirm all files are in place

Commands Reference

CommandWhat it does
reveal-md deck.mdLive preview with hot reload (default port 1948)
reveal-md deck.md --css custom.cssPreview with custom CSS
reveal-md deck.md --static _siteExport to static HTML (shareable folder)
reveal-md deck.md --print deck.pdfExport to PDF (uses Puppeteer)
reveal-md deck.md --port 3000Preview on custom port
reveal-md deck.md --theme moonUse built-in theme (moon, night, serif, etc.)

Press s during preview to open speaker notes view. Press f for fullscreen. Press o for slide overview.


Output Checklist

A completed deck directory should contain:

project/
├── deck.md               # Markdown presentation
├── custom.css             # Custom theme (if used)
├── figures/               # Generated figures (if any)
│   ├── figure_1.png
│   └── ...
├── scripts/               # R/Python scripts for figures (if any)
│   ├── figure_1.R
│   └── ...
├── _site/                 # Static HTML export (if generated)
└── deck.pdf               # PDF export (if generated)
  • All slide titles are assertions
  • One idea per slide
  • Narrative arc: Problem → Investigation → Resolution
  • Rhetoric review completed (Phase 5)
  • Speaker notes present for key slides
  • Math renders correctly (if used)
  • Tested in browser — no overflow or layout issues
  • Quality score computed and reported

Cross-References

SkillWhen to use instead/alongside
beamer-deckFor formal academic presentations (conferences, seminars) that need PDF-native output
project-deckFor project status updates (supervisor meetings, coauthor handoffs)
proofreadFor post-hoc review of text quality
literatureFor finding and verifying citations to include
quarto-courseFor full course websites with multiple lectures, exercises, and navigation

© flonat, 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 2 other files (references) in skills/quarto-deck of flonat/flonat-research.

  • SKILL.md
  • references/markdown-format.md
  • references/quality-rubric.md

Open the folder on GitHubat commit da27600

Compare with similar skills

Quarto Deck 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.

Quarto Deck compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Quarto Deck this skillflonat/flonat-research145—~2.2kAutomated safety check: PassMIT
Markdown to HTML ReportMegaSuperKitty/WeClaw370—~456Automated safety check: PassMIT
Human Reviewpetergyang/human-review1.4k—~2.1kAutomated safety check: PassMIT
Suikonwiizo/suiko114—~1.8kAutomated safety check: PassMIT
Markdown to Word Convertercat-xierluo/SuitAgent206—~559Automated safety check: PassMIT
PowerPoint Reader and BuilderTokenRhythm/opensquilla7.1k—~3.8kAutomated safety check: NotesApache-2.0

Similar skills

  • Markdown to HTML Report

    MegaSuperKitty/WeClaw

    Drafts a report in Markdown with numbered inline citations and a references section, then renders it to a styled HTML file through a Jinja2 template on Windows.

    370 GitHub stars~456 tokensUpdated 5 mo ago
    Documents & OfficeAuto-check passed
  • Human Review

    petergyang/human-review

    Open an HTML file, Markdown file, or localhost page in the browser so the user can edit text directly and leave comments on specific parts, then send all edits and comments back to you.

    1.4k GitHub stars~2.1k tokensUpdated 20 days ago
    Documents & OfficeAuto-check passed
  • Suiko

    nwiizo/suiko

    日本語文書のAI由来の均一さ、翻訳調、不自然さ、論旨、読解負荷を、決定的なRust CLIと目視で診断し、依頼に応じて書く・直す。日本語の学術論文・研究報告では、中心命題、用語、論証、DOCX/PDF納品を監査契約で確認する。Use when the user explicitly mentions suiko, asks whether Japanese text looks…

    114 GitHub stars~1.8k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Markdown to Word Converter

    cat-xierluo/SuitAgent

    Converts Markdown files into Word documents formatted to Chinese typesetting conventions, with presets for academic, legal, report and book layouts.

    206 GitHub stars~559 tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • PowerPoint Reader and Builder

    TokenRhythm/opensquilla

    Reads, edits in place, or creates PowerPoint .pptx decks, picking one of three paths based on what tools and files are available.

    7.1k GitHub stars~3.8k tokensUpdated 3 days ago
    Documents & OfficeAuto-check: notes
  • Doc Cleaner

    notoriouslab/doc-cleaner

    Convert PDF, DOCX, XLSX, and text files to clean, structured Markdown.

    309 GitHub stars~712 tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed

More from flonat/flonat-research

All 83 skills in this repo
  • Latex Posters

    flonat/flonat-research

    Create a large-format academic poster in LaTeX using beamerposter, tikzposter, or baposter.

    145 GitHub stars~1.5k tokensUpdated 8 days ago
    Auto-check: notes
  • Skill Creator

    flonat/flonat-research

    Create, revise, and evaluate reusable AI workflow skills, including trigger-quality tests.

    145 GitHub stars~4.4k tokensUpdated 8 days ago
    Auto-check passed
  • DOCX

    flonat/flonat-research

    Create, read, edit, or convert Microsoft Word documents while preserving professional document structure.

    145 GitHub stars~1.2k tokensUpdated 8 days ago
    Auto-check passed
  • PDF

    flonat/flonat-research

    Read, create, combine, split, rotate, OCR, watermark, secure, or extract content from PDF files.

    145 GitHub stars~488 tokensUpdated 8 days ago
    Auto-check passed
  • Init Project Orchestration

    flonat/flonat-research

    Create or migrate project-level agents, repeatable project workflows, and planning state from one client-neutral contract, then render repository-scoped adapters for both Claude Code and Codex.

    145 GitHub stars~1.6k tokensUpdated 8 days ago
    Auto-check passed
  • Pre Commit Audit

    flonat/flonat-research

    Deliver a fast pre-commit safety scan: file size, anonymity (author / affiliation strings in tex/bib), hardcoded secrets, and invisible-Unicode carriers.

    145 GitHub stars~2.8k tokensUpdated 8 days ago
    Auto-check: notes

Works with

Questions about Quarto Deck

What does Quarto Deck do?

Generate a Reveal.js HTML presentation from Markdown. An agent skill from flonat/flonat-research. Quarto Deck is an agent skill from flonat/flonat-research.js HTML presentation from Markdown.

When should I use Quarto Deck?

Quarto Deck fits situations like: the user asks to generate a Reveal.js HTML presentation from Markdown; tasks that involve Slides and decks; tasks that involve Markdown.

How do I install Quarto Deck in Claude Code?

Run `npx skills add flonat/flonat-research --skill quarto-deck -a claude-code`. Or copy the skill folder (skills/quarto-deck in flonat/flonat-research) into .claude/skills/quarto-deck in your project. Claude Code loads it when a task matches its description.

How do I install Quarto Deck in Codex?

Run `npx skills add flonat/flonat-research --skill quarto-deck -a codex`. Or copy the skill folder (skills/quarto-deck in flonat/flonat-research) into .agents/skills/quarto-deck in your project. Codex loads it when a task matches its description.

Can I use Quarto Deck 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 flonat/flonat-research --skill quarto-deck -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/quarto-deck, .gemini/skills/quarto-deck, .github/skills/quarto-deck and .opencode/skills/quarto-deck in your project.

What does Quarto Deck need to run?

Going by SKILL.md and its folder, Quarto Deck needs the command-line tools its instructions call (uv and npm). Our summary lists: Python 3; Node.js. Its frontmatter pre-approves these tools: Bash(reveal-md*), Bash(npx*), Bash(mkdir*), Bash(ls*), Bash(cp*), Bash(open*), Bash(R*), Bash(Rscript*), Bash(uv:*), Read, Write, Edit, Task.

Does Quarto Deck access the network?

SKILL.md contains no URLs. Its commands use uv and npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Quarto Deck 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. Review the folder before installing.

What licence does Quarto Deck use?

Quarto Deck 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 Quarto Deck use?

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

What are the alternatives to Quarto Deck?

Skills that share tags, products or a category with Quarto Deck: Markdown to HTML Report (MegaSuperKitty/WeClaw, 370 stars), Human Review (petergyang/human-review, 1.4k stars), Suiko (nwiizo/suiko, 114 stars) and Markdown to Word Converter (cat-xierluo/SuitAgent, 206 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Quarto Deck?

flonat (a GitHub user) maintains it in flonat/flonat-research, which has 145 GitHub stars. The repository holds 83 skills in this directory. The repository was last updated on September 29, 2026.

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