hyperscribe-slides

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Step 0 — Preference: Before running any renderer command, perform the theme-preference resolution block from the base
hyperscribe
skill (
~/.claude/skills/hyperscribe/SKILL.md
, section "Step 0"). It sets
$THEME
and
$MODE
. If absent, this wrapper falls back to
studio
+
light
.

步骤0 — 偏好设置： 在运行任何渲染命令之前，请执行基础
hyperscribe
技能中的主题偏好解析模块（路径：
~/.claude/skills/hyperscribe/SKILL.md
，「步骤0」章节）。该模块会设置
$THEME
和
$MODE
变量。如果不存在该模块，此包装器将默认使用
studio
主题 +
light
模式。

Hyperscribe — Slides mode

Hyperscribe — 幻灯片模式

Forces a

hyperscribe/SlideDeck

root (NOT

Page

) and emits a slide-oriented HTML file via the Hyperscribe renderer. This skill is a thin wrapper over the

hyperscribe

skill: the envelope format and renderer contract live there, this skill adds the slide-specific rules.

强制使用

hyperscribe/SlideDeck

作为根组件（而非

Page

），并通过Hyperscribe渲染器生成面向幻灯片的HTML文件。本技能是

hyperscribe

技能的轻量包装器：信封格式和渲染器协议由

hyperscribe

提供，本技能添加了幻灯片特定规则。

When to use

使用场景

User says "slides", "deck", "presentation", "walk me through", "recap as slides".
You're about to produce 5+ sequential points that would benefit from pagination.
User asks for a kickoff deck, readout, review, demo script, or training material.

Do not use for: single-page docs (use

hyperscribe

), diff reviews (use

hyperscribe-diff

), or linear prose.

用户提及「幻灯片」「演示文稿」「讲解一下」「做成幻灯片回顾」等需求时
你将要输出5个及以上的连续要点，分页展示会更清晰时
用户要求制作启动演示文稿、汇报材料、评审文档、演示脚本或培训资料时

请勿用于：单页文档（请使用

hyperscribe

）、差异评审（请使用

hyperscribe-diff

）或线性散文内容。

Rules for slide mode

幻灯片模式规则

Root MUST be
hyperscribe/SlideDeck
, never
```
hyperscribe/Page
```
. Slides don't nest inside Page.
```
SlideDeck.children
```
must be an array of
```
hyperscribe/Slide
```
objects — nothing else.
Pick
```
aspect
```
:
```
"16:9"
```
(default widescreen) or
```
"4:3"
```
(compact/legacy).
Optional
```
transition: "fade" | "slide"
```
for visual polish.
Include a
```
footer
```
with topic + date.

根组件必须是
hyperscribe/SlideDeck
，绝对不能是
```
hyperscribe/Page
```
。幻灯片不能嵌套在Page内。
```
SlideDeck.children
```
必须是
```
hyperscribe/Slide
```
对象的数组——不能包含其他内容。
选择
```
aspect
```
参数：
```
"16:9"
```
（默认宽屏）或
```
"4:3"
```
（紧凑/旧版比例）。
可选参数
```
transition: "fade" | "slide"
```
用于提升视觉效果。
包含带有主题和日期的
```
footer
```
。

Slide layout picker

幻灯片布局选择器

Layout	Use when	Props
`title`	Opening/cover slide	`title` , `subtitle`
`section`	Divider between parts	`title` , `subtitle`
`content`	Single-topic slide with bullets	`title` , `bullets`
`two-col`	Comparing two related lists	`title` , `bullets` (auto-split in half)
`quote`	Featured quote or big statement	`quote` , `subtitle` (attribution)
`image`	Screenshot or visual	`title` , `image` (URL), `subtitle` (caption)

布局	使用场景	属性
`title`	开场/封面幻灯片	`title` , `subtitle`
`section`	不同部分之间的分隔页	`title` , `subtitle`
`content`	单主题带项目符号的幻灯片	`title` , `bullets`
`two-col`	对比两个相关列表	`title` , `bullets` （自动拆分为两列）
`quote`	突出引用或重要声明	`quote` , `subtitle` （署名/出处）
`image`	截图或可视化内容	`title` , `image` （URL）, `subtitle` （说明文字）

Typical deck structure

典型演示文稿结构

```
title
```
— cover
```
section
```
— "Context" / intro divider
```
content
```
× 3–5 — each major point
```
quote
```
or
```
image
```
— emphasis beat
```
two-col
```
— comparison if relevant
```
section
```
— "Next steps" divider
```
content
```
— action items
```
title
```
— closing / thank you

Aim for 5–12 slides. If the topic is huge, suggest splitting into multiple decks rather than one 40-slider.

```
title
```
— 封面
```
section
```
— 「背景介绍」/ 引言分隔页
```
content
```
× 3–5 — 每个主要要点对应一张幻灯片
```
quote
```
或
```
image
```
— 强调性内容页
```
two-col
```
— 如有需要，添加对比页
```
section
```
— 「下一步计划」分隔页
```
content
```
— 行动项
```
title
```
— 结尾 / 致谢

目标幻灯片数量为5–12张。如果主题内容庞大，建议拆分为多个演示文稿，而非制作40页以上的长文档。

Envelope

信封格式

json

{
  "a2ui_version": "0.9",
  "catalog": "hyperscribe/v1",
  "is_task_complete": true,
  "parts": [
    {
      "component": "hyperscribe/SlideDeck",
      "props": { "aspect": "16:9", "transition": "fade", "footer": "My topic · 2026" },
      "children": [
        { "component": "hyperscribe/Slide", "props": { "layout": "title", "title": "...", "subtitle": "..." }},
        { "component": "hyperscribe/Slide", "props": { "layout": "content", "title": "...", "bullets": ["...", "..."] }},
        { "component": "hyperscribe/Slide", "props": { "layout": "title", "title": "Thanks", "subtitle": "Q&A" }}
      ]
    }
  ]
}

json

{
  "a2ui_version": "0.9",
  "catalog": "hyperscribe/v1",
  "is_task_complete": true,
  "parts": [
    {
      "component": "hyperscribe/SlideDeck",
      "props": { "aspect": "16:9", "transition": "fade", "footer": "My topic · 2026" },
      "children": [
        { "component": "hyperscribe/Slide", "props": { "layout": "title", "title": "...", "subtitle": "..." }},
        { "component": "hyperscribe/Slide", "props": { "layout": "content", "title": "...", "bullets": ["...", "..."] }},
        { "component": "hyperscribe/Slide", "props": { "layout": "title", "title": "Thanks", "subtitle": "Q&A" }}
      ]
    }
  ]
}

Render + open

渲染并打开

Same workflow as the base

hyperscribe

skill — resolve the renderer, pipe JSON, write output, open.

bash

undefined

与基础

hyperscribe

技能的工作流程相同——定位渲染器，传入JSON，写入输出文件，打开文件。

bash

undefined

Locate the hyperscribe renderer (installed via

npx skills add Atipico1/hyperscribe

or plugin marketplace).

Locate the hyperscribe renderer (installed via

npx skills add Atipico1/hyperscribe

or plugin marketplace).

HS=$(for p in
./.claude/skills/hyperscribe ~/.claude/skills/hyperscribe
./.codex/skills/hyperscribe ~/.codex/skills/hyperscribe
./.cursor/skills/hyperscribe ~/.cursor/skills/hyperscribe
./.opencode/skills/hyperscribe ~/.opencode/skills/hyperscribe
~/.claude/plugins/cache/hyperscribe-marketplace/*/plugins/hyperscribe do [ -x "$p/scripts/hyperscribe" ] && { echo "$p/scripts/hyperscribe"; break; }; done)

if [ -z "$HS" ]; then echo "hyperscribe renderer not found. Install with: npx skills add Atipico1/hyperscribe" >&2 exit 1 fi

mkdir -p ~~/.hyperscribe/out OUT=~~/.hyperscribe/out/slides-$(date +%Y%m%d-%H%M%S).html MODE_FLAG="" [ "${MODE:-}" = "light" ] && MODE_FLAG="--mode light" [ "${MODE:-}" = "dark" ] && MODE_FLAG="--mode dark"

cat <<'EOF' | "$HS" --theme "${THEME:-studio}" $MODE_FLAG --out "$OUT" <the JSON you built> EOF open "$OUT" # macOS; use xdg-open on Linux

undefined

if [ -z "$HS" ]; then echo "hyperscribe renderer not found. Install with: npx skills add Atipico1/hyperscribe" >&2 exit 1 fi

cat <<'EOF' | "$HS" --theme "${THEME:-studio}" $MODE_FLAG --out "$OUT" <the JSON you built> EOF open "$OUT" # macOS; use xdg-open on Linux

undefined

Interaction in output

输出交互说明

Users navigate with arrow keys / space / Home / End, or click the bottom nav buttons. Mention this when reporting the path.

用户可通过方向键 / 空格键 / Home键 / End键导航，或点击底部导航按钮。在告知用户文件路径时，请提及此导航方式。

Avoid

注意事项

Putting too much text on a single slide — if bullets exceed 5–6 items, split into multiple slides.
Using
```
Slide
```
inside a
```
Page
```
(fails schema validation).
Copying the user's document verbatim — distill the essence.
Nesting markdown inside Slide props —
```
bullets
```
is
```
string[]
```
, plain text only.

单张幻灯片不要放置过多文本——如果项目符号超过5–6项，请拆分到多张幻灯片中。
不要在
```
Page
```
内嵌套
```
Slide
```
（会导致 schema 验证失败）。
不要直接复制用户文档原文——提炼核心内容。
不要在Slide属性中嵌套markdown——
```
bullets
```
是
```
string[]
```
类型，仅支持纯文本。

hyperscribe-slides

Original

Translation

Hyperscribe — Slides mode

Hyperscribe — 幻灯片模式

When to use

使用场景

Rules for slide mode

幻灯片模式规则

Slide layout picker

幻灯片布局选择器

Typical deck structure

典型演示文稿结构

Envelope

信封格式

Render + open

渲染并打开

Locate the hyperscribe renderer (installed via
`npx skills add Atipico1/hyperscribe`
or plugin marketplace).

Locate the hyperscribe renderer (installed via
`npx skills add Atipico1/hyperscribe`
or plugin marketplace).

Interaction in output

输出交互说明

Avoid

注意事项