diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..8b1ff3c
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 sunbigfly
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/README.md b/README.md
index 23bded6..5e33d56 100644
--- a/README.md
+++ b/README.md
@@ -1,14 +1,156 @@
-# PPT Agent -- 专业演示文稿全流程 AI 生成助手
+# PPT Agent Skill
-模仿万元/页级别 PPT 设计公司的完整工作流，输出高质量 HTML 演示文稿 + 可编辑矢量 PPTX。
+**[English](#english) | [中文](#中文)**
-## 工作流概览
+---
+
+
+
+## English
+
+> A professional AI-powered presentation generation assistant that simulates the complete workflow of a top-tier PPT design company (quoted at $1,000+/page), outputting high-quality HTML presentations + editable vector PPTX files.
+
+### Workflow Overview
```
-需求调研 -> 资料搜集 -> 大纲策划 -> 策划稿 -> 风格+配图+HTML设计稿 -> 后处理(SVG+PPTX)
+Requirements Interview → Research → Outline → Planning Draft → Style + Images + HTML Design → Post-processing (SVG + PPTX)
```
-## 输出产物
+### Key Features
+
+| Feature | Description |
+|---------|-------------|
+| **5-Step Pipeline** | Requirements → Research → Outline → Planning → Design, mimicking professional PPT companies |
+| **8 Preset Styles** | Dark Tech / Xiaomi Orange / Blue White / Royal Red / Fresh Green / Luxury Purple / Minimal Gray / Vibrant Rainbow |
+| **Bento Grid Layout** | 7 flexible card-based layouts driven by content, not templates |
+| **Smart Illustrations** | AI-generated images with 5 visual fusion techniques (fade blend, tinted overlay, ambient background, etc.) |
+| **Typography System** | 7-level font scale + spacing hierarchy + Chinese-English mixed typesetting rules |
+| **Color Proportion** | 60-30-10 rule enforcement + accent color constraints |
+| **Data Visualization** | 8 pure CSS/SVG chart types (progress bars, ring charts, sparklines, waffle charts, KPI cards, etc.) |
+| **Cross-page Narrative** | Density alternation, chapter color progression, cover-ending visual echo |
+| **Footer System** | Unified footer with chapter info + page numbers across all slides |
+| **PPTX Compatible** | HTML → SVG → PPTX pipeline, right-click "Convert to Shape" in PPT 365 for full editing |
+
+### Output Files
+
+| File | Description |
+|------|-------------|
+| `preview.html` | Browser-based paginated preview (auto-generated) |
+| `presentation.pptx` | PPTX file, right-click "Convert to Shape" in PPT 365 for editing |
+| `svg/*.svg` | Per-page vector SVG, drag into PPT directly |
+| `slides/*.html` | Per-page HTML source files |
+
+### Requirements
+
+#### Required
+
+- **Node.js** >= 18 (Puppeteer + dom-to-svg)
+- **Python** >= 3.8 (script execution)
+- **python-pptx** (PPTX generation)
+
+#### Auto-installed (on first run)
+
+- `puppeteer` — Headless Chrome
+- `dom-to-svg` — DOM to SVG conversion (preserves editable ``)
+- `esbuild` — Bundles dom-to-svg for browser use
+
+#### Quick Install
+
+```bash
+# Python dependencies
+pip install python-pptx lxml Pillow
+
+# Node.js dependencies (auto-installed on first script run, or install manually)
+npm install puppeteer dom-to-svg
+```
+
+### Directory Structure
+
+```
+ppt-agent-skill/
+ SKILL.md # Main workflow instructions (Agent entry point)
+ README.md # This file
+ references/
+ prompts.md # 5 Prompt templates
+ style-system.md # 8 preset styles + CSS variables
+ bento-grid.md # 7 layout specs + card types
+ method.md # Core methodology
+ scripts/
+ html_packager.py # Merge multi-page HTML into paginated preview
+ html2svg.py # HTML → SVG (dom-to-svg, preserves editable text)
+ svg2pptx.py # SVG → PPTX (OOXML native SVG embedding)
+```
+
+### Script Usage
+
+```bash
+# Merge preview
+python3 scripts/html_packager.py -o preview.html
+
+# HTML to SVG
+python3 scripts/html2svg.py -o
+
+# SVG to PPTX
+python3 scripts/svg2pptx.py -o output.pptx --html-dir
+```
+
+### Technical Architecture
+
+```
+HTML slides
+ |
+ v
+[Puppeteer] opens HTML → [dom-to-svg] DOM direct to SVG
+ | (preserves elements, editable)
+ | (base64 inline images)
+ v
+SVG files
+ |
+ v
+[python-pptx + lxml] OOXML svgBlip embedding
+ | (PNG fallback for older Office)
+ v
+presentation.pptx
+```
+
+### Trigger Phrases
+
+In a Claude conversation, these expressions will trigger this Skill:
+
+- "Help me make a PPT" / "Create a presentation about X"
+- "Make slides" / "Make a deck" / "Make training materials"
+- "Turn this document into a PPT"
+
+---
+
+
+
+## 中文
+
+> 模仿万元/页级别 PPT 设计公司的完整工作流，输出高质量 HTML 演示文稿 + 可编辑矢量 PPTX。
+
+### 工作流概览
+
+```
+需求调研 → 资料搜集 → 大纲策划 → 策划稿 → 风格+配图+HTML设计稿 → 后处理(SVG+PPTX)
+```
+
+### 核心特性
+
+| 特性 | 说明 |
+|------|------|
+| **6步Pipeline** | 需求 → 搜索 → 大纲 → 策划 → 设计 → 后处理，模拟专业 PPT 公司工作流 |
+| **8种预置风格** | 暗黑科技 / 小米橙 / 蓝白商务 / 朱红宫墙 / 清新自然 / 紫金奢华 / 极简灰白 / 活力彩虹 |
+| **Bento Grid 布局** | 7 种卡片式灵活布局，内容驱动版式 |
+| **智能配图** | AI 生成配图 + 5 种视觉融入技法（渐隐融合/色调蒙版/氛围底图等） |
+| **排版系统** | 7 级字号阶梯 + 间距层级 + 中英文混排规则 |
+| **色彩比例** | 60-30-10 法则 + accent 色使用约束 |
+| **数据可视化** | 8 种纯 CSS/SVG 图表（进度条/环形图/迷你折线/点阵图/KPI 卡等） |
+| **跨页叙事** | 密度交替节奏 / 章节色彩递进 / 封面-结尾呼应 / 渐进揭示 |
+| **页脚系统** | 统一页脚（章节信息 + 页码），跨页导航 |
+| **PPTX 兼容** | HTML → SVG → PPTX 管线，PPT 365 中右键"转换为形状"即可编辑 |
+
+### 输出产物
| 文件 | 说明 |
|------|------|
@@ -17,26 +159,21 @@
| `svg/*.svg` | 单页矢量 SVG，可直接拖入 PPT |
| `slides/*.html` | 单页 HTML 源文件 |
-## 环境依赖
+### 环境依赖
-### 必须
+#### 必须
- **Node.js** >= 18（Puppeteer + dom-to-svg 需要）
- **Python** >= 3.8（脚本执行）
- **python-pptx**（PPTX 生成）
-### 自动安装（首次运行自动处理）
+#### 自动安装（首次运行自动处理）
-- `puppeteer` -- Headless Chrome
-- `dom-to-svg` -- DOM 转 SVG（保留 `` 可编辑）
-- `esbuild` -- 将 dom-to-svg 打包为浏览器 bundle
+- `puppeteer` — Headless Chrome
+- `dom-to-svg` — DOM 转 SVG（保留 `` 可编辑）
+- `esbuild` — 将 dom-to-svg 打包为浏览器 bundle
-### 可选（降级方案）
-
-- `pdf2svg` -- 当 dom-to-svg 不可用时的降级方案（文字变 path，不可编辑）
-- `inkscape` -- SVG 转 EMF（备用）
-
-### 一键安装
+#### 一键安装
```bash
# Python 依赖
@@ -44,15 +181,12 @@ pip install python-pptx lxml Pillow
# Node.js 依赖（首次运行脚本时自动安装，也可手动提前安装）
npm install puppeteer dom-to-svg
-
-# 可选：降级方案
-sudo apt install pdf2svg
```
-## 目录结构
+### 目录结构
```
-ppt-agent-workflow-san/
+ppt-agent-skill/
SKILL.md # 主工作流指令（Agent 入口）
README.md # 本文件
references/
@@ -62,59 +196,24 @@ ppt-agent-workflow-san/
method.md # 核心方法论
scripts/
html_packager.py # 多页 HTML 合并为翻页预览
- html2svg.py # HTML -> SVG（dom-to-svg，保留文字可编辑）
- svg2pptx.py # SVG -> PPTX（OOXML 原生 SVG 嵌入）
+ html2svg.py # HTML → SVG（dom-to-svg，保留文字可编辑）
+ svg2pptx.py # SVG → PPTX（OOXML 原生 SVG 嵌入）
```
-## 脚本用法
-
-### html_packager.py -- 合并预览
+### 脚本用法
```bash
+# 合并预览
python3 scripts/html_packager.py -o preview.html
-```
-### html2svg.py -- HTML 转 SVG
-
-```bash
+# HTML 转 SVG
python3 scripts/html2svg.py -o
-```
-- 底层：Puppeteer + dom-to-svg（DOM 直接转 SVG，`` 可编辑）
-- 图片：自动读取 `![]()
` 引用的文件转 base64 嵌入
-- 降级：dom-to-svg 不可用时自动退回 Puppeteer PDF + pdf2svg
-
-### svg2pptx.py -- SVG 转 PPTX
-
-```bash
+# SVG 转 PPTX
python3 scripts/svg2pptx.py -o output.pptx --html-dir
```
-- SVG 以 OOXML `asvg:svgBlip` 扩展原生嵌入 PPTX
-- 同时生成 PNG 回退图（兼容旧版 Office）
-- PPT 365 中右键 -> "转换为形状" 可编辑文字和形状
-
-## 技术架构
-
-```
-HTML slides
- |
- v
-[Puppeteer] 打开 HTML -> [dom-to-svg] DOM 直接转 SVG
- | (保留 元素，文字可编辑)
- | (base64 内联图片)
- | (color -> fill 属性后处理)
- v
-SVG files
- |
- v
-[python-pptx + lxml] OOXML svgBlip 嵌入
- | (PNG 回退图兼容旧版 Office)
- v
-presentation.pptx
-```
-
-## 触发方式
+### 触发方式
在 Claude 对话中，以下表达会触发此 Skill：