SuperAPI AI 工具集

html-ppt-skill

设计与创作

查看项目

更新于 10-15 15:14

技能介绍

html-ppt-skill 是由 ara.so 提供的 AgentSkill,用于制作专业 HTML 演示文稿。其介绍称其为世界级 AgentSkill,使用 36 个主题、14 个完整演示模板、31 种页面布局和 47 种动画(27 种 CSS 动画加 20 种 canvas FX),全部为纯静态 HTML/CSS/JS,零构建步骤。

安装方式提供两种。一是通过 agent runtime 注册:npx skills add https://github.com/lewislulu/html-ppt-skill;二是直接克隆仓库:git clone https://github.com/lewislulu/html-ppt-skill。

可通过脚本从基础模板脚手架生成新演示:./scripts/new-deck.sh my-talk,输出示例路径为 examples/my-talk/index.html,生成后即可编辑。

项目结构中,assets 目录包含 base.css(共享 tokens 与基础元素)、runtime.js(键盘导航、演讲者模式、总览)、themes/.css(36 个主题 token 文件)以及 animations 子目录(animations.css 含 27 个具名 CSS 动画,fx-runtime.js 在幻灯片进入时自动初始化 [data-fx],fx/.js 为 20 个 canvas FX 模块)。templates 目录包含 deck.html(最小起步模板)、theme-showcase.html(以 iframe 隔离展示全部 36 个主题)、layout-showcase.html(全部 31 种布局)、animation-showcase.html(47 个动画幻灯片)、full-decks-index.html(14 个模板库画廊)、full-decks/<name>/(14 个独立作用域的多幻灯片演示)以及 single-page/*.html(31 个带演示数据的布局文件)。examples/demo-deck/ 为一个完整可运行的演示。

每份演示遵循统一结构:引用 assets/base.css、一个主题文件以及 runtime.js。可选的还有动画样式表。页面使用 section class="slide" 并配合 data-layout 属性定义布局。主题共有 36 个,通过替换单个 link 即可改变整套外观,全部位于 assets/themes/*.css,涵盖浅色/编辑类(minimal-white、editorial-serif、soft-pastel、academic-paper)、深色/氛围类(tokyo-night、dracula、catppuccin-mocha、gruvbox-dark、nord)、大胆/设计类(neo-brutalism、glassmorphism、cyberpunk-neon、memphis-pop、vaporwave)、商务/专业类(corporate-clean、pitch-deck-vc、swiss-grid)以及特殊/文化类(xiaohongshu-white、japanese-minimal、terminal-green)。

布局共 31 种,通过每张幻灯片 section 上的 data-layout 设置,分为结构性布局(cover、toc、section-divider、thanks、cta)、内容型布局(bullets、two-column、three-column、big-quote、table、code、diff、terminal)、数据/统计型布局(stat-highlight、kpi-grid、chart-bar、chart-line、chart-pie、chart-radar)、图表/流程型布局(flow-diagram、timeline、roadmap、mindmap、arch-diagram、process-steps、gantt)、对比型布局(comparison、pros-cons、todo-checklist)和视觉型布局(image-hero、image-grid)。

CSS 动画方面,可将类添加到任意元素,使用 --delay CSS 变量实现错峰。包括淡入/入场类(rise-in、fade-up、zoom-pop、blur-in)、文字效果类(typewriter、glitch-in、neon-glow、shimmer-sweep、gradient-flow)、列表类(stagger-list)、数字类(counter-up,配合 data-target)、3D/高级类(card-flip-3d、cube-rotate-3d、page-turn-3d、perspective-zoom)以及滚动/运动类(marquee-scroll、kenburns、parallax-tilt、ripple-reveal、spotlight)。

Canvas FX 动画通过 data-fx 属性在幻灯片进入时触发,包括粒子效果(particle-burst)、庆祝类(confetti-cannon)、技术/数据类(knowledge-graph、neural-net、matrix-rain、data-stream)、太空/氛围类(starfield、constellation、galaxy-swirl、orbit-ring)、文字 FX 类(typewriter-multi、word-cascade、letter-explode、counter-explosion)以及视觉类(gradient-blob、sparkle-trail、shockwave、firework、chain-react、magnetic-field)。fx-runtime.js 会在幻灯片进入时自动初始化这些效果,无需额外 JS。

完整演示模板共 14 个,位于 templates/full-decks/<name>/,涵盖商务/通用类(pitch-deck、product-launch、tech-sharing、weekly-report、course-module)、社交/中文类(xhs-post 为 9 页 3:4 比例、xhs-white-editorial、xhs-pastel-card)、技术/深色类(graphify-dark-graph、hermes-cyber-terminal、knowledge-arch-blueprint)以及特定风格类(obsidian-claude-gradient、testing-safety-alert、dir-key-nav-minimal)。每个演示使用作用域化的 .tpl-<name> CSS,可安全地并排嵌入多个演示。

介绍中给出了三种常见演示模式。融资路演风格(VC Style)使用 pitch-deck-vc 主题与 gradient-blob、confetti-cannon 等 FX,包含封面、牵引数据(counter-up 数字)、问题/解决方案两栏以及 CTA 页。技术分享/工程风格使用 tokyo-night 主题与 neural-net FX,包含封面、代码布局以及时间线布局。小红书风格(3:4 比例)使用 xiaohongshu-white 主题,通过内联 style 设置 .slide 的 aspect-ratio 为 3/4、max-width 480px,展示中文图文内容。

介绍文档在最后部分被截断,关于适用场景和限制的完整说明暂未提供。