Communitygithub.com

ASoudy/AGS

從無到有建立動畫豐富的 HTML 簡報,或將 PowerPoint 檔案轉換為網頁簡報。當使用者想建立簡報、轉換 PPT/PPTX 為網頁,或為演講/提案製作投影片時使用。幫助非設計師透過視覺探索(而非抽象選擇)發現自己的美感。

AGS 是什麼?

這個技能用於建立零依賴、動畫豐富的 HTML 簡報,完全在瀏覽器中執行,靈感來自視覺探索方法。它支援三種主要模式:從頭建立新簡報、轉換 PPT/PPTX 檔案,以及增強現有 HTML 簡報。核心原則是「展示,而非告知」,透過產生視覺預覽來幫助使用者探索設計風格,而不是要求他們填寫抽象問卷。它明確規定簡報必須「完全適應視窗」,每個投影片都必須填滿視窗且無內部捲動,並使用 clamp() 等技巧確保響應式縮放。此技能可與 Claude Code、Cursor 或 Codex 等 AI 代理工具搭配使用,協助開發者或技術人員快速產出高品質、可自訂的簡報。

相容平台~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
  • [presentation-name].html

僅在簡報包含提取的或使用者提供的圖片時,才使用 assets/ 資料夾。

必要的結構:

  • 語義化的投影片區段
  • 來自 STYLE_PRESETS.md 的視窗安全 CSS 基礎
  • 用於主題值的 CSS 自訂屬性
  • 用於鍵盤、滾輪與觸控導覽的簡報控制器類別
  • 用於揭示動畫的 Intersection Observer
  • 減少動畫支援

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. 萃取後,執行與新簡報相同的風格選擇工作流程。

保持轉換跨平台。不要依賴僅限 macOS 的工具,當 Python 可以完成工作時。

實作需求

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:當簡報有意借用 Apple 玻璃美學時
  • 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.

相關技能