Communitygithub.com

ASoudy/AGS

从头创建惊艳的、富含动画效果的HTML演示文稿,或直接转换PowerPoint文件。适用于用户想要构建演示文稿、将PPT/PPTX转换为网页、或为演讲/推介创建幻灯片的情况。帮助非设计师通过视觉探索而非抽象选择来发现自己的审美。

AGS 是什么?

该技能(ASoudy/AGS)是一个专业工具,专门用于创建零依赖、动画丰富的HTML演示文稿,这些文稿直接在浏览器中运行。其主要价值在于无需任何外部库或框架,即可生成自包含、高性能且视觉效果独特的幻灯片。该技能支持三种主要工作模式:从零开始创建新演示文稿、将PPT/PPTX文件转换为HTML、以及增强现有的HTML演示文稿。它特别强调“视觉探索”方法,能为不确定设计偏好的用户生成多个风格预览,通过直观选择而非填写抽象问卷来找到合适的视觉风格。该技能可广泛应用于各类演讲场景,如技术讲座、产品推介、工作坊或内部更新,并优先支持macOS、Linux和Windows等主流操作系统。其核心约束包括:每张幻灯片必须严格适配视口且无内部滚动、所有样式和动画通过内联CSS和JavaScript实现、以及全面支持无障碍访问(如语义化HTML结构和`prefers-reduced-motion`)。最终交付的是一个符合生产质量的HTML文件,可本地打开并完全通过键盘、触摸和鼠标滚轮进行导航。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/claude_skills_libraries/landing-page-mastery/skills/frontend-slides

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

前端幻灯片

创建零依赖、动画丰富的HTML演示文稿,完全在浏览器中运行。

灵感来源于 zarazhangrui(致谢:@zarazhangrui)展示的视觉探索方法。

何时激活

  • 创建演讲幻灯片、产品推介幻灯片、工作坊幻灯片或内部演示文稿
  • 将 .ppt 或 .pptx 幻灯片转换为 HTML 演示文稿
  • 改进现有 HTML 演示文稿的布局、动画或排版
  • 帮助尚不清楚设计偏好的用户探索演示样式

不可妥协的要求

  1. 零依赖:默认生成一个自包含的 HTML 文件,内联 CSS 和 JS。
  2. 视口适配是强制性的:每张幻灯片必须恰好适配一个视口,且无内部滚动。
  3. 展示而非说明:使用视觉预览代替抽象的风格问卷。
  4. 独特设计:避免通用的紫色渐变、Inter字体配白底、模板化的幻灯片。
  5. 生产质量:代码应包含注释、可访问、响应式且性能良好。

在生成之前,请阅读 STYLE_PRESETS.md 以获取视口安全 CSS 基础、密度限制、预设目录和 CSS 陷阱。

工作流程

1. 检测模式

选择一条路径:

  • 新建演示文稿:用户有主题、笔记或完整草稿
  • PPT 转换:用户有 .ppt 或 .pptx 文件
  • 增强:用户已有 HTML 幻灯片并希望改进

2. 探索内容

仅询问最少必要信息:

  • 目的:产品推介、教学、会议演讲、内部更新
  • 长度:短(5-10页)、中(10-20页)、长(20页以上)
  • 内容状态:完成稿件、粗略笔记、仅有主题

如果用户有内容,请在样式设计前要求用户粘贴内容。

3. 探索风格

默认采用视觉探索。

如果用户已经知道想要的预设,则跳过预览,直接使用该预设。

否则:

  1. 询问用户希望演示文稿传达何种感受:令人印象深刻、充满活力、专注、鼓舞人心。
  2. 在 .ecc-design/slide-previews/ 目录中生成 3 个单页幻灯片预览文件。
  3. 每个预览必须是自包含的,清晰展示排版、色彩和动画,并控制在约 100 行幻灯片内容以内。
  4. 询问用户保留哪个预览或混合哪些元素。

根据情绪映射风格时,请参考 STYLE_PRESETS.md 中的预设指南。

4. 构建演示文稿

输出以下文件之一:

  • presentation.html
  • [演示文稿名称].html

仅当幻灯片中包含提取的或用户提供的图片时,才使用 assets/ 文件夹。

必需的结构:

  • 语义化的幻灯片节(section)
  • 来自 STYLE_PRESETS.md 的视口安全 CSS 基础
  • 用于主题值的 CSS 自定义属性
  • 用于键盘、滚轮和触摸导航的演示文稿控制器类
  • 用于显示动画的 Intersection Observer
  • 减少动画支持(prefers-reduced-motion)

5. 强制视口适配

将此视为硬性关卡。

规则:

  • 每个 .slide 必须使用 height: 100vh; height: 100dvh; overflow: hidden;
  • 所有文字和间距必须使用 clamp() 进行缩放
  • 当内容无法适配时,拆分为多个幻灯片
  • 永远不要通过将文字缩小到可读尺寸以下来解决溢出问题
  • 绝不允许幻灯片内出现滚动条

使用 STYLE_PRESETS.md 中的密度限制和强制 CSS 块。

6. 验证

在以下尺寸检查完成的幻灯片:

  • 1920x1080
  • 1280x720
  • 768x1024
  • 375x667
  • 667x375

如果浏览器自动化工具可用,请使用它来验证没有幻灯片溢出,并且键盘导航正常工作。

7. 交付

移交时:

  • 删除临时预览文件,除非用户希望保留
  • 在适用时,使用平台对应的打开工具打开幻灯片
  • 汇总文件路径、使用的预设、幻灯片数量以及简单的主题自定义点

使用当前操作系统对应的打开工具:

  • macOS:open file.html
  • Linux:xdg-open file.html
  • Windows:start "" file.html

PPT / PPTX 转换

对于 PowerPoint 转换:

  1. 优先使用 python3 和 python-pptx 来提取文本、图片和备注。
  2. 如果 python-pptx 不可用,询问用户是安装它还是回退到手动/基于导出的工作流程。
  3. 保留幻灯片顺序、演讲者备注和提取的素材。
  4. 提取后,运行与新建演示文稿相同的风格选择工作流程。

确保转换跨平台。当 Python 可以胜任时,不要依赖仅在 macOS 上可用的工具。

实现要求

HTML / CSS

  • 除非用户明确要求多文件项目,否则使用内联 CSS 和 JS。
  • 字体可来自 Google Fonts 或 Fontshare。
  • 优先使用氛围背景、强大的字体层级和清晰的视觉方向。
  • 使用抽象形状、渐变、网格、噪点和几何图形,而不是插图。

JavaScript

包含:

  • 键盘导航
  • 触摸/滑动导航
  • 鼠标滚轮导航
  • 进度指示器或幻灯片索引
  • 进入时触发展示动画

无障碍访问

  • 使用语义化结构(main、section、nav)
  • 保持对比度可读
  • 支持仅键盘导航
  • 尊重 prefers-reduced-motion

内容密度限制

除非用户明确要求更密集的幻灯片且可读性仍能保持,否则使用以下最大值:

幻灯片类型限制
标题页1 个标题 + 1 个副标题 + 可选标语
内容页1 个标题 + 4-6 个要点或 2 个短段落
特性网格最多 6 个卡片
代码页最多 8-10 行
引用页1 条引用 + 署名
图片页1 张图片,受视口约束

反模式

  • 没有视觉标识的通用启动渐变
  • 系统字体幻灯片(除非是故意设计的编辑风格)
  • 冗长的要点列表
  • 需要滚动的代码块
  • 在短屏上会断裂的固定高度内容框
  • 无效的否定 CSS 函数,如 -clamp(...)

相关 ECC 技能

  • frontend-patterns:用于幻灯片周围的组件和交互模式
  • liquid-glass-design:当演示文稿有意借鉴苹果玻璃美学时
  • e2e-testing:如果需要自动浏览器验证最终幻灯片

交付清单

  • 演示文稿可在浏览器中从本地文件运行
  • 每张幻灯片都能适配视口,无需滚动
  • 风格独特且有意图
  • 动画有意义而非杂乱
  • 尊重减少动画设置
  • 移交时说明文件路径和自定义点

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

相关技能