Agent skill

Offline HTML Talk Decks

by lijigang in lijigang/ljg-skills

Builds single-file offline HTML talk decks from Org or Markdown outlines, with faithful layout or editorial condensing and keyboard navigation.

MITAuto-check passedDocuments & Office

SKILL.md written in Chinese; this summary is our English description.

Install Offline HTML Talk Decks

skills CLI
$ npx skills add lijigang/ljg-skills --skill ljg-present -a claude-code

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

GitHub CLI
$ gh skill install lijigang/ljg-skills ljg-present --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/lijigang/ljg-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/ljg-present .claude/skills/ljg-present && 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
ljg-present
GitHub stars
7.5k
Token cost
~506 tokens
SKILL.md length
105 words
Files
27 (incl. references)
Skills in repo
26
Repo updated
First seen
Licence
MIT

At a glance

Builds single-file offline HTML talk decks from Org or Markdown outlines, with faithful layout or editorial condensing and keyboard navigation.

  • Turning a Markdown or Org outline into a presentation without changing the wording
  • SKILL.md covers Workflow Routing, Gotchas, 两种内容契约 and 设计与实现, plus 3 more sections
  • Runs TypeScript scripts from its folder
  • Distilling a talk script into on-screen statements with full speaker notes

What it does

ljg-present turns a presentation outline in Org or Markdown, or a talk script the author has authorized you to condense, into a single offline HTML deck. Slides are laid out by semantic role, such as a big statement, comparison, Unicode relationship diagram, evidence or chapter page. The default theme is a dark hacker-dark, with lighter hacker, black, red and yellow themes available. Fonts are embedded, charts are inline and there are no animations. The skill text is in Chinese.

It has two content modes. Faithful layout keeps the original wording, order, tables, code and source images when an outline exists and rewriting is not authorized. Editorial mode applies when you ask for the talk to be distilled, regrouped or its diagrams redrawn: on-screen text may then be rewritten within that grant, an editing basis is recorded and the full talk goes into speaker notes. Merely asking for a presentation does not authorize cutting the author's content. The deck is built with Tools/BuildDeck.ts and saved as an HTML file in Downloads, with keyboard navigation, F for full screen and N for notes.

When your agent uses it

  • Turning a Markdown or Org outline into a presentation without changing the wording
  • Distilling a talk script into on-screen statements with full speaker notes
  • Redrawing an ASCII diagram as a Unicode relationship diagram
  • Choosing a dark or light theme for an offline deck

Example prompts

  • “Make a presentation from ./talk/outline.md exactly as written, without editing the words.”
  • “Condense my talk script into slides and put the full spoken text in the speaker notes.”
  • “把旧的 ASCII 图改成 Unicode 关系图并放进演示。”

Requirements

  • An isolated browser (Interceptor) for the visual check

What it can do on your machine

Read from SKILL.md and the folder at commit 9e75497. 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 script files (TypeScript, from the files we listed), 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

Offline HTML Talk Decks loads about 506 tokens when it runs, and up to ~43k if it reads all its reference files. Until then it costs about 50 tokens; SKILL.md has 105 words of instructions outside code blocks.

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

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 lijigang/ljg-skills at commit 9e75497, republished under its MIT licence (© lijigang). 105 words, ~506 tokens.

Download SKILL.mdSave it as .claude/skills/ljg-present/SKILL.md (or your agent's skills folder). This skill also uses 26 other files; get the full folder from GitHub.
name
ljg-present
description
Unix 气质的演讲设计与保真排版。把 Org/Markdown 提纲或经授权提炼的讲稿制成单文件离线 HTML;以语义角色选择巨句、对照、Unicode 关系图、证据与章节版式。默认深色,支持讲稿层、原生图表与翻页笔。USE WHEN present、做演讲、slides、按 outline 美化、把讲述精髓放上屏幕。NOT FOR 未经授权改写作者内容或生成企业 PPT。
user_invocable
true
version
4.8.0

ljg-present:演讲铸造器

让观众一眼找到这一页的主角,让讲者有足够的提示继续展开。Unix 气质来自精确的关系、自然的文字、清楚的主次和有意保留的空白。

Workflow Routing

工作入口
生成、重排或改进演示Workflows/Generate.md

Gotchas

  • share、talk 等用途标签不决定颜色。未指定视觉主题时使用 hacker-dark。
  • 两行可以是一个判断。role 由讲述功能决定;行数只参与字号与分页。
  • 标题、主体、提示句不是必填三件套。主句已经完成表达时,让它独立站住。
  • Unicode 连接线使用等宽网格,中文节点独立排版。不要把中文逐字塞进固定字符格。
  • 静态通过不等于画面成立。构建工具固定模板;浏览器探针核对实际绘制的页面,截图另检视觉主次。

两种内容契约

模式何时使用保真对象
faithful 保真排版已有投影提纲;未授权改写原文字句、顺序、表格、代码和源图
editorial 演讲编排用户已要求提炼讲稿、重组展示或重绘图观点、证据、限定条件、数值和关系;上屏文字可在授权范围内改写

当前请求已授权的提炼或重绘直接执行,不重复询问。演讲编排记录 editingBasis,上屏内容以 sourceIds 回到完整来源;完整讲述放入 notes,按 N 查看。仅有「做成演示」不自动授权删改作者内容。

设计与实现

  • 先读 DesignSystem.md,按相关版式查看 CompositionReference.md 的实际样张。
  • 数据契约见 RenderingSpec.md;关系图、原生图表与源代码的边界见 ChartSpec.md。
  • 使用 Tools/BuildDeck.ts 把数据装入 SloganTemplate.html;不在产物末尾补 CSS,不另写渲染分支。
  • 保留源中的章节转折与停顿。内容节点数、页数和图数都不是质量目标。
  • 核心观点、重要限制和数据按投影距离保持可读;辅助信息退后或进入讲稿,不能缩小核心信息来制造留白。

主题

显式选择 > 明确的 theme_* 视觉标签 > hacker-dark。普通话题、用途标签不参与主题选择。

意图或参数theme
默认、Unix、terminal、暗色hacker-dark
浅色 Hacker、--hacker、兼容 --cyberhacker
-b / --theme=blackblack
-r / --theme=redred
-y / --theme=yellowyellow

交付

一个 ~/Downloads/{title}.html,字体内嵌,图表内联,离线、零动效。→ ↓ Space Enter j PageDown 前进;← ↑ k PageUp 后退;Home/End 首末页;F 全屏;N 讲稿。滚动图形和讲稿时不触发翻页。

静态验证检查当前模板与源数据;使用 Interceptor 隔离浏览器加载 Tools/ProbeDeck.js,再看整套缩略图与代表页。隔离浏览器不可用时保留产物并如实报告未完成视觉复验,不改用主浏览器冒充验收。

Examples

  • 「按原提纲做演示,别改字」→ faithful,根据语义选版式,必要时沿源边界续页。
  • 「把讲述精髓放进展示,供我现场展开」→ editorial,提炼主张、对照或关系,完整讲稿进入 notes。
  • 「把旧 ASCII 图改成 Unicode」→ 记录重绘授权,以节点、连接和方向核对新图;真实代码仍逐字符保留。

© lijigang, 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 26 other files (references) in skills/ljg-present of lijigang/ljg-skills.

  • SKILL.md
  • ChartSpec.md
  • CompositionReference.md
  • DesignSystem.md
  • Fonts/IBMPlexMono-Bold.ttf
  • Fonts/IBMPlexMono-OFL.txt
  • Fonts/IBMPlexMono-Regular.ttf
  • References/Chapter.png
  • References/Compare.png
  • References/CompositionDeck.json
  • References/Diagram.png
  • References/Evidence.png
  • References/RegressionDeck.json
  • References/Statement.png
  • RenderingSpec.md
  • SloganTemplate.html
  • Tools/BuildDeck.help.md
  • Tools/BuildDeck.ts
  • … and 9 more

Open the folder on GitHubat commit 9e75497

Compare with similar skills

Offline HTML Talk Decks 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.

Offline HTML Talk Decks compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Offline HTML Talk Decks this skilllijigang/ljg-skills7.5k—~506Automated safety check: PassMIT
Frontend Slideszarazhangrui/frontend-slides30k16 repos~7kAutomated safety check: PassMIT
HTML PPT Studiolewislulu/html-ppt-skill8.6k4 repos~4.7kAutomated safety check: PassMIT
Single-File HTML Slide Decksop7418/guizang-ppt-skill27k1 repos~6.3kAutomated safety check: PassAGPL-3.0
HTML Presentation Structure Guideshanraisshan/claude-code-best-practice67k—~882Automated safety check: PassMIT
Openkb Deck EditorialVectifyAI/OpenKB4.8k1 repos~2.1kAutomated safety check: PassApache-2.0

Similar skills

  • Frontend Slides

    zarazhangrui/frontend-slides

    Builds animated HTML slide decks that run in the browser with no dependencies, or converts PowerPoint files to the web, starting from visual style previews.

    30k GitHub starsUsed in 16 repos~7k tokens
    Documents & OfficeAuto-check passed
  • HTML PPT Studio

    lewislulu/html-ppt-skill

    Authors static HTML presentations from a library of themes, layouts and animations, with keyboard navigation, for talks, pitch decks and reports.

    8.6k GitHub starsUsed in 4 repos~4.7k tokens
    Documents & OfficeAuto-check passed
  • Single-File HTML Slide Decks

    op7418/guizang-ppt-skill

    Generates single-file HTML slide decks with horizontal paging, WebGL backgrounds and a presenter view, in an editorial-magazine style or a Swiss-style layout.

    27k GitHub starsUsed in 1 repo~6.3k tokens
    Documents & OfficeAuto-check passed
  • HTML Presentation Structure Guide

    shanraisshan/claude-code-best-practice

    Documents how a single-file HTML slide deck is built: slide markup, the four-level journey bar, navigation and the renumbering rules after edits.

    67k GitHub stars~882 tokensUpdated today
    Documents & OfficeAuto-check passed
  • Openkb Deck Editorial

    VectifyAI/OpenKB

    A skill your agent uses when the user asks the openkb chat to make a deck / slide presentation / PPT / slides / 演示稿 / 幻灯片 from their compiled KB content.

    4.8k GitHub starsUsed in 1 repo~2.1k tokens
    Documents & OfficeAuto-check passed
  • Presentation Styling Reference

    shanraisshan/claude-code-best-practice

    Reference for the CSS classes, HTML slide patterns and code-block highlighting spans used in a project's presentation/index.html slide deck.

    67k GitHub stars~780 tokensUpdated today
    Documents & OfficeAuto-check passed

More from lijigang/ljg-skills

All 26 skills in this repo
  • Whole-Book Explainer Notes

    lijigang/ljg-skills

    Explains a whole book to someone who has not read it, keeping its specific content and showing how its threads connect, and saves the result as an Org note.

    7.5k GitHub stars~1k tokensUpdated yesterday
    Auto-check passed
  • Ljg Paper

    lijigang/ljg-skills

    Explain research papers to readers without a specialist background: what the paper studies, what the authors contribute, how the findings follow, and what the evidence does not establish.

    7.5k GitHub stars~798 tokensUpdated yesterday
    Auto-check passed
  • Text to PNG Card Caster

    lijigang/ljg-skills

    Turns text, URLs or local files into tall PNG cards through HTML typography, with four modes: long reading card, full-text layout, comic and whiteboard.

    7.5k GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed
  • Turns a named classical Chinese chapter, such as one from the Tao Te Ching or the Analects, into a single annotated PNG image with notes and commentary.

    7.5k GitHub stars~551 tokensUpdated yesterday
    Auto-check passed
  • Constraint Engine

    lijigang/ljg-skills

    Finds the handful of constraints that truly define a domain, role, product or debate, grades each by hardness, and explains the behavior those constraints produce.

    7.5k GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • Turns an article, paper or book into a directed chain of sharp questions and four-part answers that retraces the author's reasoning, saved as an org-mode note.

    7.5k GitHub stars~590 tokensUpdated yesterday
    Auto-check passed

Questions about Offline HTML Talk Decks

What does Offline HTML Talk Decks do?

Builds single-file offline HTML talk decks from Org or Markdown outlines, with faithful layout or editorial condensing and keyboard navigation. ljg-present turns a presentation outline in Org or Markdown, or a talk script the author has authorized you to condense, into a single offline HTML deck. Slides are laid out by semantic role, such as a big statement, comparison, Unicode relationship diagram, evidence or chapter page.

When should I use Offline HTML Talk Decks?

Offline HTML Talk Decks fits situations like: turning a Markdown or Org outline into a presentation without changing the wording; distilling a talk script into on-screen statements with full speaker notes; redrawing an ASCII diagram as a Unicode relationship diagram; choosing a dark or light theme for an offline deck.

How do I install Offline HTML Talk Decks in Claude Code?

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

How do I install Offline HTML Talk Decks in Codex?

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

Can I use Offline HTML Talk Decks 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 lijigang/ljg-skills --skill ljg-present -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ljg-present, .gemini/skills/ljg-present, .github/skills/ljg-present and .opencode/skills/ljg-present in your project.

What does Offline HTML Talk Decks need to run?

Going by SKILL.md and its folder, Offline HTML Talk Decks needs TypeScript for the scripts in its folder. Our summary lists: An isolated browser (Interceptor) for the visual check.

Does Offline HTML Talk Decks 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 Offline HTML Talk Decks 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 Offline HTML Talk Decks use?

Offline HTML Talk Decks 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 Offline HTML Talk Decks use?

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

What are the alternatives to Offline HTML Talk Decks?

Skills that share tags, products or a category with Offline HTML Talk Decks: Frontend Slides (zarazhangrui/frontend-slides, 30k stars), HTML PPT Studio (lewislulu/html-ppt-skill, 8.6k stars), Single-File HTML Slide Decks (op7418/guizang-ppt-skill, 27k stars) and HTML Presentation Structure Guide (shanraisshan/claude-code-best-practice, 67k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Offline HTML Talk Decks?

lijigang (a GitHub user) maintains it in lijigang/ljg-skills, which has 7,474 GitHub stars. The repository holds 26 skills in this directory. The repository was last updated on October 8, 2026.

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