magazine-web-ppt
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseMagazine Web Ppt
Magazine Web Ppt
这个 Skill 做什么
What This Skill Does
生成一份单文件 HTML的横向翻页 PPT,视觉基调是:
- 电子杂志 + 电子墨水混血风格
- WebGL 流体 / 等高线 / 色散背景(hero 页可见)
- 衬线标题(Noto Serif SC + Playfair Display)+ 非衬线正文(Noto Sans SC + Inter)+ 等宽元数据(IBM Plex Mono)
- Lucide 线性图标(不用 emoji)
- 横向左右翻页(键盘 ← →、滚轮、触屏滑动、底部圆点、ESC 索引)
- 主题平滑插值:翻到 hero 页时颜色和 shader 柔顺过渡
这个 skill 的美学不是"商务 PPT",也不是"消费互联网 UI"——它像 Monocle 杂志贴上了代码后的样子。
Generate a single-file HTML horizontal-swipe PPT with the following visual style:
- Hybrid style of e-magazine + e-ink
- WebGL fluid/contour/dispersion background (visible on hero page)
- Serif titles (Noto Serif SC + Playfair Display) + sans-serif body text (Noto Sans SC + Inter) + monospaced metadata (IBM Plex Mono)
- Lucide linear icons (no emojis)
- Horizontal left/right page turning (keyboard ← →, scroll wheel, touch swipe, bottom dots, ESC for index)
- Smooth theme interpolation: Colors and shaders transition smoothly when flipping to the hero page
The aesthetics of this skill are neither "business PPT" nor "consumer internet UI" — it looks like Monocle magazine combined with code.
何时使用
When to Use
合适的场景:
- 线下分享 / 行业内部讲话 / 私享会
- AI 新产品发布 / demo day
- 带有强烈个人风格的演讲
- 需要"一次做完,不用翻页工具"的网页版 slides
不合适的场景:
- 大段表格数据、图表叠加(用常规 PPT)
- 培训课件(信息密度不够)
- 需要多人协作编辑(这是静态 HTML)
Suitable scenarios:
- Offline sharing / internal industry talks / private sessions
- AI new product launches / demo days
- Speeches with strong personal style
- Web-based slides that "can be done once without page-turning tools"
Unsuitable scenarios:
- Large sections of tabular data, overlapping charts (use regular PPT)
- Training courseware (insufficient information density)
- Needs multi-person collaborative editing (this is static HTML)
工作流
Workflow
Step 0 · 选方向(Direction · 必做的第一步)
Step 0 · Choose Direction (Mandatory First Step)
在问 6 个澄清问题之前,先让用户在 5 个 magazine 方向里挑一个。每个方向都把"主题色 / 推荐 layout / chrome 风格 / 推荐 slide 数"打包好,挑了方向就回答掉一半澄清问题。
打开 ,整段拷过来给用户看 5 个方向的 1-line summary,然后让他选:
references/styles.md1. Monocle Editorial · 国际杂志风 ✦ 默认
2. WIRED Tech · 数据 + 工程
3. Kinfolk Slow · 慢生活 / 人文
4. Domus Architectural · 建筑 / 空间感
5. Lab / Reference · 学术 + 工艺手册如果用户说"不知道,你推荐"——默认推 Monocle Editorial,因为它失败概率最低。如果用户提到"AI / benchmark / 技术发布"——推 WIRED;"读书 / 私享 / 朋友圈"——推 Kinfolk;"设计 / 建筑 / portfolio"——推 Domus;"研究 / 学术 / 方法论"——推 Lab。
挑完方向后,在项目目录下创建或更新 ,第一行写清方向 + 主题色 + 受众 + 时长(模板见 末尾)。全程不要换方向——半路换 = 前面全废。
项目记录.mdstyles.mdBefore asking 6 clarification questions, let the user choose one of 5 magazine directions first. Each direction packages "theme color / recommended layout / chrome style / recommended number of slides" — choosing a direction answers half of the clarification questions.
Open , copy the entire section to show users the 1-line summary of the 5 directions, then ask them to choose:
references/styles.md1. Monocle Editorial · International Magazine Style ✦ Default
2. WIRED Tech · Data + Engineering
3. Kinfolk Slow · Slow Living / Humanities
4. Domus Architectural · Architecture / Sense of Space
5. Lab / Reference · Academic + Craft ManualIf the user says "I don't know, recommend one" — default to Monocle Editorial, as it has the lowest failure rate. If the user mentions "AI / benchmark / tech launch" — recommend WIRED; "reading / private sharing / social media" — recommend Kinfolk; "design / architecture / portfolio" — recommend Domus; "research / academic / methodology" — recommend Lab.
After choosing the direction, create or update (Project Record.md) in the project directory, and write the direction + theme color + audience + duration on the first line (template at the end of ). Do not change the direction halfway — changing it will invalidate all previous work.
项目记录.mdstyles.mdStep 1 · 需求澄清(动手前必做)
Step 1 · Requirement Clarification (Mandatory Before Starting)
如果用户已经给了完整的大纲 + 图片,可以跳过直接进 Step 2。
如果用户只给了主题或一个模糊想法,用这 6 个问题逐个对齐后再动手。不要基于猜测就开始写 slide——一旦结构定错,后期翻修代价很高:
If the user has provided a complete outline + images, skip directly to Step 2.
If the user only provides a theme or vague idea, align requirements with these 6 questions before starting. Do not start writing slides based on guesses — once the structure is wrong, the cost of later revisions is very high:
6 问澄清清单
6 Clarification Questions
第 5 题已在 Step 0 选方向时一并回答(方向→主题色)。下面的 5 题里,第 5 题留白即可。
| # | 问题 | 为什么要问 |
|---|---|---|
| 1 | 受众是谁?分享场景?(行业内部 / 商业发布 / demo day / 私享会) | 决定语言风格和深度 |
| 2 | 分享时长? | 15 分钟 ≈ 10 页,30 分钟 ≈ 20 页,45 分钟 ≈ 25-30 页(每个方向的推荐范围见 |
| 3 | 有没有原始素材?(文档 / 数据 / 旧 PPT / 文章链接) | 有素材就基于素材,没有就帮他搭 |
| 4 | 有没有图片?放在哪? | 详见下方"图片约定" |
| 5 | ✓ 已在 Step 0 由方向决定 | |
| 6 | 有没有硬约束?(必须包含 XX 数据 / 不能出现 YY) | 避免返工 |
Question 5 is already answered in Step 0 when choosing the direction (direction → theme color). Leave Question 5 blank in the following 5 questions.
| # | Question | Why Ask |
|---|---|---|
| 1 | Who is the audience? What is the sharing scenario? (internal industry / commercial launch / demo day / private session) | Determines language style and depth |
| 2 | What is the sharing duration? | 15 minutes ≈ 10 pages, 30 minutes ≈ 20 pages, 45 minutes ≈ 25-30 pages (recommended range for each direction is in |
| 3 | Are there any original materials? (documents / data / old PPT / article links) | Base on materials if available; build the structure if not |
| 4 | Are there any images? Where to place them? | See "Image Guidelines" below |
| 5 | ✓ Answered in Step 0 via direction selection | |
| 6 | Are there any hard constraints? (must include XX data / cannot include YY) | Avoid rework |
大纲协助(如果用户没有大纲)
Outline Assistance (If User Has No Outline)
用"叙事弧"模板搭骨架,再填内容:
钩子(Hook) → 1 页 : 抛一个反差 / 问题 / 硬数据让人停下来
定调(Context) → 1-2 页 : 说明背景 / 你是谁 / 为什么讲这个
主体(Core) → 3-5 页 : 核心内容,用 Layout 4/5/6/9/10 穿插
转折(Shift) → 1 页 : 打破预期 / 提出新观点
收束(Takeaway) → 1-2 页 : 金句 / 悬念问题 / 行动建议叙事弧 + 页数规划 + 主题节奏表(见 ),三张表对齐后再进 Step 2。
layouts.md大纲建议保存为 或 ,便于后续迭代。
项目记录.md大纲-v1.mdUse the "narrative arc" template to build the skeleton, then fill in content:
Hook → 1 page : Present a contrast / question / hard data to grab attention
Context → 1-2 pages : Explain background / who you are / why you're talking about this
Core → 3-5 pages : Core content, interspersed with Layout 4/5/6/9/10
Shift → 1 page : Break expectations / propose new perspectives
Takeaway → 1-2 pages : Golden quote / suspense question / action recommendationAlign the narrative arc + page count plan + theme rhythm table (see ), then proceed to Step 2.
layouts.mdIt is recommended to save the outline as or (Outline-v1.md) for subsequent iterations.
项目记录.md大纲-v1.md图片约定(告知用户)
Image Guidelines (Inform User)
在动手前向用户说清:
- 文件夹位置:下(和
项目/XXX/ppt/images/同级)index.html - 命名规范:,例如
{页号}-{语义}.{ext}/01-cover.jpg/03-figma.jpg05-dashboard.png- 页号补零便于排序
- 语义用英文,短、具体、和内容对应
- 规格建议:
- 单张 ≥ 1600px 宽(避免大屏模糊)
- JPG 用于照片/截图,PNG 用于透明 UI/图表
- 总大小控制在 10MB 内(影响翻页流畅度)
- 如何替换:保持同名覆盖最稳(HTML 里不用改路径);如果文件名变了,记得全局搜 改成新名
images/旧名 - 没图怎么办:和用户对齐,可以先用占位色块生成结构,等图片后期补;但要告知 layout 4/5/10 等图文混排页没图就没法验证视觉效果
Clarify the following to the user before starting:
- Folder location: Under (same level as
项目/XXX/ppt/images/)index.html - Naming convention: , e.g.,
{page-number}-{semantics}.{ext}/01-cover.jpg/03-figma.jpg05-dashboard.png- Pad page numbers with zeros for sorting
- Use short, specific English semantics corresponding to content
- Specification suggestions:
- Single image ≥ 1600px wide (avoid blurriness on large screens)
- JPG for photos/screenshots, PNG for transparent UI/charts
- Total size ≤ 10MB (affects page-turning smoothness)
- How to replace: The safest way is to overwrite with the same name (no need to change paths in HTML); if the file name changes, remember to globally search for and replace with the new name
images/old-name - What if no images? Align with the user: you can generate the structure with placeholder blocks first, then add images later; but inform the user that layout pages like 4/5/10 with mixed text and images cannot verify visual effects without images
Step 2 · 拷贝模板
Step 2 · Copy Template
从 拷贝一份到目标位置(通常是 ),同时在同级建一个 文件夹准备接图片。
assets/template.html项目/XXX/ppt/index.htmlimages/bash
mkdir -p "项目/XXX/ppt/images"
cp "<SKILL_ROOT>/assets/template.html" "项目/XXX/ppt/index.html"template.html<main id="deck">Copy a copy from to the target location (usually ), and create an folder at the same level to prepare for receiving images.
assets/template.html项目/XXX/ppt/index.htmlimages/bash
mkdir -p "项目/XXX/ppt/images"
cp "<SKILL_ROOT>/assets/template.html" "项目/XXX/ppt/index.html"template.html<main id="deck">2.1 · 必改占位符(容易漏)
2.1 · Mandatory Placeholder Replacement (Easy to Miss)
拷贝后立刻改掉以下占位符,否则浏览器 Tab 会显示"[必填] 替换为 PPT 标题"这种尴尬文字:
| 位置 | 原始 | 需改为 |
|---|---|---|
| | 实际 deck 标题(如 |
每次拷贝完 template.html 第一件事:grep 一下"[必填]" 确认全部替换完。
Immediately replace the following placeholders after copying, otherwise the browser tab will display embarrassing text like "[Required] Replace with PPT Title":
| Location | Original | Need to Change to |
|---|---|---|
| | Actual deck title (e.g., |
First thing after copying template.html: grep for "[必填]" to confirm all placeholders are replaced.
2.2 · 选定主题色(5 套预设 · 不允许自定义)
2.2 · Select Theme Color (5 Presets · Customization Not Allowed)
本 skill 只允许从 5 套精心调配的预设里选一套,不接受用户自定义 hex 值——颜色搭配错了画面瞬间变丑,保护美学比给自由更重要。
| # | 主题 | 适合 |
|---|---|---|
| 1 | 🖋 墨水经典 | 通用 / 商业发布 / 不知道选啥的默认 |
| 2 | 🌊 靛蓝瓷 | 科技 / 研究 / 数据 / 技术发布会 |
| 3 | 🌿 森林墨 | 自然 / 可持续 / 文化 / 非虚构 |
| 4 | 🍂 牛皮纸 | 怀旧 / 人文 / 文学 / 独立杂志 |
| 5 | 🌙 沙丘 | 艺术 / 设计 / 创意 / 画廊 |
操作:
- 基于内容主题推荐一套,或直接问用户选哪一套
- 打开 ,找到对应主题的
references/themes.md块:root - 整体替换 (已拷贝版本)开头
assets/template.html块里标有"主题色"注释的那几行(:root{/--ink/--ink-rgb/--paper/--paper-rgb/--paper-tint)--ink-tint - 其他 CSS 都走 ,无需任何其他改动
var(--...)
硬规则:
- 一份 deck 只用一套主题,不要中途换色
- 不要接受用户给的任意 hex 值——委婉拒绝并展示 5 套让选
- 不要混搭(例如 ink 取墨水经典、paper 取沙丘)——会彻底违和
This skill only allows choosing one of 5 carefully curated preset sets, and does not accept custom hex values from users — wrong color matching will instantly ruin the visual effect, so protecting aesthetics is more important than giving freedom.
| # | Theme | Suitable For |
|---|---|---|
| 1 | 🖋 Ink Classic | General / commercial launch / default when unsure |
| 2 | 🌊 Indigo Porcelain | Tech / research / data / tech conferences |
| 3 | 🌿 Forest Ink | Nature / sustainability / culture / non-fiction |
| 4 | 🍂 Kraft Paper | Nostalgia / humanities / literature / independent magazines |
| 5 | 🌙 Dune | Art / design / creativity / galleries |
Operations:
- Recommend a set based on content theme, or directly ask the user to choose
- Open , find the
references/themes.mdblock corresponding to the theme:root - Replace the entire section of lines marked with "theme color" comments (/
--ink/--ink-rgb/--paper/--paper-rgb/--paper-tint) in the--ink-tintblock at the beginning of the copied:root{assets/template.html - Other CSS uses , no other changes needed
var(--...)
Hard Rules:
- Only use one theme set per deck, do not change colors halfway
- Do not accept arbitrary hex values from users — politely decline and show the 5 sets for selection
- Do not mix and match (e.g., take ink from Ink Classic and paper from Dune) — it will be completely inconsistent
Step 3 · 填充内容
Step 3 · Fill Content
3.0 · 预检:类名必须在 template.html 里有定义(最重要)
3.0 · Pre-check: Class Names Must Be Defined in template.html (Most Important)
这是所有生成问题的源头。layouts.md 的骨架使用了很多类名( / / / / 等),如果 的 里没有对应定义,浏览器会 fallback 到默认样式——大标题变成非衬线、数据卡片挤成一团、pipeline 糊成一行、图片堆到页面底部。
h-heroh-xlstat-cardpipelinegrid-2-7-5assets/template.html<style>在写任何 slide 代码之前:
- 先 Read (至少读到
assets/template.html块末尾)<style> - 对照 layouts.md 的 Pre-flight 列表,确认你要用的每个类都在 里存在
<style> - 如果某个类缺失:在 template.html 的 里补上,不要在每个 slide 里 inline 重写
<style> - template.html 是唯一的类名来源——不要发明新类名,如需自定义用 inline
style="..."
常见容易遗漏的类(必须预先确认存在):
/ / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / /
h-heroh-xlh-subh-mdleadkickermeta-rowstat-cardstat-labelstat-nbstat-unitstat-notepipeline-sectionpipeline-labelpipelinestepstep-nbstep-titlestep-descgrid-2-7-5grid-2-6-6grid-2-8-4grid-3-3grid-6grid-3grid-4frameframe-imgimg-capcalloutcallout-srcchromefootThis is the source of all generation issues. The skeleton in layouts.md uses many class names ( / / / / , etc.). If there is no corresponding definition in the block of , the browser will fall back to default styles — large titles become sans-serif, data cards are squeezed together, pipelines are blurred into one line, images pile up at the bottom of the page.
h-heroh-xlstat-cardpipelinegrid-2-7-5<style>assets/template.htmlBefore writing any slide code:
- Read first (at least until the end of the
assets/template.htmlblock)<style> - Compare with the Pre-flight list in layouts.md to confirm each class you want to use exists in the block
<style> - If a class is missing: Add it to the block of template.html, do not rewrite it inline in each slide
<style> - template.html is the only source of class names — do not invent new class names; use inline for customization if needed
style="..."
Common easily missed classes (must confirm existence in advance):
/ / / / / / / / / / / / / / / / / / / / / / / / / / / / / / / /
h-heroh-xlh-subh-mdleadkickermeta-rowstat-cardstat-labelstat-nbstat-unitstat-notepipeline-sectionpipeline-labelpipelinestepstep-nbstep-titlestep-descgrid-2-7-5grid-2-6-6grid-2-8-4grid-3-3grid-6grid-3grid-4frameframe-imgimg-capcalloutcallout-srcchromefoot3.0.5 · 规划主题节奏(和类预检同等重要)
3.0.5 · Plan Theme Rhythm (Equally Important as Class Pre-check)
在挑布局之前,必须先列出每一页的主题 class( / / / )并写到文档或草稿里对齐。详细规则看 开头的"主题节奏规划"一节。
hero darkhero lightlightdarkreferences/layouts.md强制规则:
- 每页 section 必须带 /
light/dark/hero light之一,不要只写hero darkhero - 连续 3 页以上同主题 = 视觉疲劳,不允许
- 8 页以上必须有 ≥1 个 + ≥1 个
hero darkhero light - 整个 deck 不能只有 正文页,必须有
light正文页制造呼吸dark - 每 3-4 页插入 1 个 hero 页(封面/幕封/问题/大引用)
生成后自检: 列出所有主题,人工确认节奏合理再交付。
grep 'class="slide' index.htmlBefore choosing layouts, you must list the theme class ( / / / ) for each page and write it in a document or draft for alignment. Detailed rules are in the "Theme Rhythm Planning" section at the beginning of .
hero darkhero lightlightdarkreferences/layouts.mdMandatory Rules:
- Each page section must have one of /
light/dark/hero light, do not only writehero darkhero - More than 3 consecutive pages with the same theme = visual fatigue, not allowed
- Decks with 8+ pages must have ≥1 + ≥1
hero darkhero light - The entire deck cannot only have body pages, must have
lightbody pages to create visual breathing spacedark - Insert 1 hero page (cover/divider/question/big quote) every 3-4 pages
Self-check after generation: to list all themes, manually confirm the rhythm is reasonable before delivery.
grep 'class="slide' index.html3.1 · 挑布局
3.1 · Choose Layout
不要从零写 slide。打开 ,里面有 10 种现成布局骨架,每种都是完整可粘贴的 代码块:
references/layouts.md<section>| Layout | 用途 |
|---|---|
| 1. 开场封面 | 第 1 页 |
| 2. 章节幕封 | 每幕开场 |
| 3. 数据大字报 | 抛硬数据 |
| 4. 左文右图(Quote + Image) | 身份反差 / 故事 |
| 5. 图片网格 | 多图对比 / 截图实证 |
| 6. 两列流水线(Pipeline) | 工作流程 |
| 7. 悬念收束 / 问题页 | 幕末 / 收尾 |
| 8. 大引用页(Big Quote) | 衬线金句 / takeaway |
| 9. 并列对比(Before / After) | 旧模式 vs 新模式 |
| 10. 图文混排(Lead Image + Side Text) | 信息密集的图文页 |
选对应 layout,粘过去,改文案和图片路径即可。务必先完成 3.0 预检。
Do not write slides from scratch. Open , which contains 10 ready-made layout skeletons, each is a complete pasteable code block:
references/layouts.md<section>| Layout | Purpose |
|---|---|
| 1. Opening Cover | Page 1 |
| 2. Chapter Divider | Opening of each act |
| 3. Data Big Poster | Present hard data |
| 4. Text Left, Image Right (Quote + Image) | Identity contrast / storytelling |
| 5. Image Grid | Multi-image comparison / screenshot evidence |
| 6. Two-column Pipeline | Workflow |
| 7. Suspense Closure / Question Page | End of act / conclusion |
| 8. Big Quote Page | Serif golden quote / takeaway |
| 9. Side-by-side Comparison (Before / After) | Old mode vs new mode |
| 10. Mixed Text and Image (Lead Image + Side Text) | Information-dense text-image page |
Select the corresponding layout, paste it, then modify the copy and image paths. Be sure to complete Step 3.0 pre-check first.
3.2 · 图片比例规范
3.2 · Image Ratio Guidelines
永远用标准比例,不要用原图奇葩比例(如 ):
2592/1798| 场景 | 推荐比例 |
|---|---|
| 左文右图 主图 | 16:10 或 4:3 + |
| 图片网格(多图对比) | 固定 |
| 左小图 + 右文字 | 1:1 或 3:2 |
| 全屏主视觉 | 16:9 + |
| 图文混排小插图 | 3:2 或 3:4 |
图片绝不使用 ——会滑到 cell 底被浏览器工具栏遮挡。用 grid 容器 + (template 已预设)让图片贴顶即可;左列若想贴底,用 flex column + 。
align-self:endalign-items:startjustify-content:space-between组件细节(字体、颜色、网格、图标、callout、stat-card 等)在 。
references/components.mdAlways use standard ratios, do not use weird original ratios (e.g., ):
2592/1798| Scenario | Recommended Ratio |
|---|---|
| Main image for Text Left, Image Right | 16:10 or 4:3 + |
| Image Grid (multi-image comparison) | Fixed |
| Small left image + right text | 1:1 or 3:2 |
| Full-screen main visual | 16:9 + |
| Small illustration for mixed text and image | 3:2 or 3:4 |
Never use for images — it will slide to the bottom of the cell and be blocked by the browser toolbar. Use grid container + (pre-configured in template) to make images stick to the top; if you want the left column to stick to the bottom, use flex column + .
align-self:endalign-items:startjustify-content:space-betweenComponent details (fonts, colors, grids, icons, callouts, stat-cards, etc.) are in .
references/components.mdStep 4 · 对照检查清单自检
Step 4 · Self-check Against Checklist
生成完一定要打开 ,逐项对照。里面总结了真实迭代过程中踩过的所有坑,P0 级别的问题(emoji、图片撑破、标题换行、字体分工)必须全部通过。
references/checklist.md特别要注意的几条:
- 大标题必须是衬线字体——如果显示成非衬线,99% 是 Step 3.0 预检没做,类在 template.html 里缺失
h-hero - 图片网格里只用 ,不用
height:Nvh(会撑破)aspect-ratio - 图片不能堆到页面底部——不要用 ,用 grid +
align-self:end(见 Step 3.2)align-items:start - 图片只能用标准比例(16:10 / 4:3 / 3:2 / 1:1 / 16:9),不要复制原图的奇葩比例
- 中文大标题 ≤ 5 字且 (避免 1 字 1 行)
nowrap - 用 Lucide,不用 emoji
- 标题用衬线,正文用非衬线,元数据用等宽
After generation, be sure to open and check item by item. It summarizes all pitfalls encountered in real iteration processes, and P0-level issues (emojis, image overflow, title line breaks, font division) must all pass.
references/checklist.mdSeveral key points to pay special attention to:
- Large titles must be serif fonts — if they display as sans-serif, 99% of the time Step 3.0 pre-check was not done and the class is missing in template.html
h-hero - Only use in image grids, not
height:Nvh(it will cause overflow)aspect-ratio - Images cannot pile up at the bottom of the page — do not use , use grid +
align-self:end(see Step 3.2)align-items:start - Images can only use standard ratios (16:10 / 4:3 / 3:2 / 1:1 / 16:9), do not copy weird original ratios
- Chinese large titles ≤ 5 characters and (avoid one character per line)
nowrap - Use Lucide, not emojis
- Titles use serif, body text uses sans-serif, metadata uses monospaced
Step 5 · 本地预览
Step 5 · Local Preview
直接在浏览器打开 就行。macOS 下:
index.htmlbash
open "项目/XXX/ppt/index.html"不需要本地服务器。图片走相对路径 。
images/xxx.pngJust open directly in the browser. On macOS:
index.htmlbash
open "项目/XXX/ppt/index.html"No local server is needed. Images use relative paths .
images/xxx.pngStep 6 · 迭代
Step 6 · Iteration
根据用户反馈修改——模板的 CSS 已经高度参数化,90% 的调整都是改 inline style(字号 / 高度 / 间距 )。
font-size:Xvwheight:Yvhgap:ZvhModify based on user feedback — the template's CSS is highly parameterized, 90% of adjustments are changing inline styles (font size / height / gap ).
font-size:Xvwheight:Yvhgap:Zvh资源文件导览
Resource File Overview
magazine-web-ppt/
├── SKILL.md ← 你正在读
├── assets/
│ ├── template.html ← 完整的可运行模板(种子文件)
│ └── example-slides.html ← 9 页样例 deck(用于 Examples 预览)
└── references/
├── styles.md ← 5 个 magazine 方向(Monocle / WIRED / Kinfolk / Domus / Lab)
├── components.md ← 组件手册(字体、色、网格、图标、callout、stat、pipeline...)
├── layouts.md ← 10 种页面布局骨架(可直接粘贴)
├── themes.md ← 5 套主题色预设(只能选不能自定义)
└── checklist.md ← 质量检查清单(P0/P1/P2/P3 分级)加载顺序建议:
- 先读完 (这个文件)了解整体
SKILL.md - Step 0 选方向时,读 ——5 个方向各自打包好了主题色 + 推荐 layout + chrome 风格
styles.md - Step 1 需求澄清完成后,如果方向需要确认,再读 看色板细节
themes.md - 动手前 Read 的
assets/template.html块——这是类名的唯一来源,缺类会导致整页样式崩<style> - 读 挑布局(顶部有 Pre-flight 类名清单和主题节奏规划)
layouts.md - 细节调整时读 查组件
components.md - 生成后读 自检(顶部 P0-0 规则强制预检)
checklist.md
magazine-web-ppt/
├── SKILL.md ← You are reading this
├── assets/
│ ├── template.html ← Complete runnable template (seed file)
│ └── example-slides.html ← 9-page sample deck (for preview)
└── references/
├── styles.md ← 5 magazine directions (Monocle / WIRED / Kinfolk / Domus / Lab)
├── components.md ← Component manual (fonts, colors, grids, icons, callouts, stats, pipelines...)
├── layouts.md ← 10 page layout skeletons (can be directly pasted)
├── themes.md ← 5 preset theme color sets (only selectable, not customizable)
└── checklist.md ← Quality checklist (P0/P1/P2/P3 grading)Recommended loading order:
- First read (this file) to understand the overall picture
SKILL.md - When choosing direction in Step 0, read — each of the 5 directions packages theme color + recommended layout + chrome style
styles.md - After completing requirement clarification in Step 1, if direction needs confirmation, read to see color palette details
themes.md - Read the block of
<style>before starting — this is the only source of class names; missing classes will cause entire page styles to breakassets/template.html - Read to choose layouts (top has Pre-flight class name list and theme rhythm planning)
layouts.md - Read to check components when adjusting details
components.md - Read for self-check after generation (top P0-0 rules are mandatory pre-checks)
checklist.md
核心设计原则(哲学)
Core Design Principles (Philosophy)
这些原则是"一人公司"分享 PPT 的 5 轮迭代总结出来的。违反其中任何一条,视觉感都会垮。
- 克制优于炫技 — WebGL 背景只在 hero 页透出,普通页几乎看不见
- 结构优于装饰 — 不用阴影、不用浮动卡片、不用 padding box,一切信息靠大字号 + 字体对比 + 网格留白
- 内容层级由字号和字体共同定义 — 最大衬线 = 主标题,中衬线 = 副标,大非衬线 = lead,小非衬线 = body,等宽 = 元数据
- 图片是第一公民 — 图片只裁底部,保证顶部和左右完整;网格用 固定,不要用
height:Nvh撑aspect-ratio - 节奏靠 hero 页 — hero 和 non-hero 交替,才不累眼睛
- 术语统一 — Skills 就是 Skills,不要中英混合翻译
These principles are summarized from 5 iterations of "one-person company" sharing PPTs. Violating any of them will ruin the visual effect.
- Restraint over flashiness — WebGL background only shows through on hero pages, almost invisible on regular pages
- Structure over decoration — no shadows, no floating cards, no padding boxes; all information is defined by large font sizes + font contrast + grid white space
- Content hierarchy is defined by both font size and font type — largest serif = main title, medium serif = subtitle, large sans-serif = lead, small sans-serif = body, monospaced = metadata
- Images are first-class citizens — images are only cropped at the bottom to ensure top and left/right are complete; grids use fixed , do not use
height:Nvhto stretchaspect-ratio - Rhythm relies on hero pages — alternating hero and non-hero pages prevents eye fatigue
- Terminology consistency — Skills are Skills, do not mix Chinese and English translations
参考作品
Reference Works
本 skill 的视觉基调参考了:
- 歸藏 "一人公司:被 AI 折叠的组织" 分享(2026-04-22,27 页)
- Monocle 杂志的版式
- YC 总裁 Garry Tan "Thin Harness, Fat Skills" 那篇博客的 demo
可以把它们当做风格锚点。
The visual style of this skill references:
- Guizang's "One-Person Company: Organizations Folded by AI" sharing (April 22, 2026, 27 pages)
- Layouts of Monocle magazine
- The demo in YC President Garry Tan's blog "Thin Harness, Fat Skills"
You can use them as style anchors.