Claude Skills
CollectionsCompareWorkflowsNominate
Sign inSign up
© 2026 Curated Agent Skills·Learn more about Agent Skills
Back to repository

beauty-normal-step3

verified

JSON data generation and HTML rendering. Automatically invoked during step 3 of the beauty-normal command to convert slide content into JSON data structure and generate JSON-driven McKinsey-style HTML files, including CSS styles, JSON data, and JavaScript rendering logic. JSON数据生成与HTML渲染。在beauty-normal命令的步骤3执行时自动调用,将幻灯片内容转换为JSON数据结构,并生成JSON驱动的McKinsey风格HTML文件,包含CSS样式、JSON数据和JavaScript渲染逻辑。

View on GitHub

Marketplace

within7-plugins-tools

Within-7/minto-plugin-tools

Plugin

html-presentation-beautifier

design

Repository
Verified Org

Within-7/minto-plugin-tools
1stars

html-presentation-beautifier/skills/beauty-normal-step3/SKILL.md

Last Verified

February 2, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/Within-7/minto-plugin-tools/blob/main/html-presentation-beautifier/skills/beauty-normal-step3/SKILL.md -a claude-code --skill beauty-normal-step3

Installation paths:

Claude
.claude/skills/beauty-normal-step3/
Powered by add-skill CLI

Instructions

# Beauty-Normal 步骤3:JSON数据生成与HTML渲染 / Beauty-Normal Step 3: JSON Data Generation and HTML Rendering

## 目标 / Goal

将步骤2生成的幻灯片页面清单转换为JSON数据结构,并使用JSON+HTML方式生成完整的、可运行的McKinsey风格HTML文件。

Convert the slide page list generated in Step 2 into JSON data structure, and use JSON+HTML method to generate a complete, runnable McKinsey-style HTML file.

## ⚠️ 核心原则

**🔑 必须读取并参考skill资源:**
- **必须读** `beauty-html/references/best-practices.md`
- **必须读** `beauty-html/references/mckinsey-design-system.md`
- **必须读** `beauty-html/assets/presentation-template.html`
- **必须读** `beauty-html/assets/TEMPLATE_USAGE_GUIDE.md`
- **必须读** `beauty-html/assets/INDEX.md`
- **必须读** `beauty-json/SKILL.md`(⚠️ 新增:JSON数据结构规范)

**⚠️ Token限制处理原则:**

**🔑 最核心规则(必须严格遵守):如果数据内容过大,或者token过长,则自动使用'继续'进行'分段'加载数据,绝对不能精简、偷工减料的节省token,严禁为了省token而跳过内容或使用摘要**

**当遇到 token 限制或上下文长度问题时,必须使用"继续"分页方式,绝对禁止:**
- ❌ 压缩或省略资源读取
- ❌ 跳过必读资源
- ❌ 简化执行步骤
- ❌ 减少生成内容
- ❌ 使用摘要代替完整内容
- ❌ 精简数据内容
- ❌ 偷工减料节省token

**正确处理方式:使用"继续"机制**
```
1. 在完成当前可执行的部分后
2. 明确说明:"由于 token 限制,任务未完成,请输入'继续'以获取剩余部分"
3. 等待用户输入"继续"后
4. 继续执行剩余步骤
5. 重复直到任务完全完成
```

**分段加载原则:**
- ✅ **完整保留**:每段数据都必须100%保留,无遗漏、无压缩
- ✅ **分段清晰**:明确标注当前是第几段,共几段
- ✅ **连续执行**:每段完成后自动提示"继续",等待用户确认
- ✅ **质量优先**:宁可多轮对话,不可降低质量
- ❌ **禁止精简**:绝对不能为了省token而精简数据内容
- ❌ **禁止偷工**:绝对不能为了省token而偷工减料

**关键规则:**
- ✅ **质量 > 速度**:宁可多轮对话,不可降低质量
- ✅ **完整 > 简化**:宁可分多次执行,不可压缩内容
- ✅ **标准 > 妥协**:宁可触发继续,不可偷工减料

## 📋 执行流程(4个子步骤)

```
步骤3.1:读取必读资源
  ↓
步骤3.2:设计JSON数据结构
  ↓
步骤3.3:生成完整HTML文件(4个阶段)
  ├─ 阶段1:生成HTML框架和完整CSS样式
  ├─ 阶段2:生成JSON数据(包含所有幻灯片内容)
  ├─ 阶段3:生成HTML容器和JavaScript渲染逻辑
  └─ 阶段4:生成结束标签
  ↓
步骤3.4:验证代码质量
```

---

## 步骤 3.1:读取必读资源

### 目标

完整读取所有必读资源,为后续JSON数据设计和HTML生成提供参考。

### 必读资源清单

```
1. beauty-html/references/best-practices.md
   - HTML最佳实践
   - 语义化标签使用
   - 可访问性要求

2. beauty-html/references/mckinsey-design-system.md
   - McKinsey配色方案
   - 字体规范
   - 间距标准
   - 布局原则

3. beauty-html/assets/presentation-template.html
   - HTML结构模板
   - 导航功能
   - 响应式设计

4. beauty-html/assets/TEMPLATE_USAGE_GUIDE.md
   -

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
26157 chars