What it does
AetherViz Master - 互动教育可视化建筑师,将任意教学主题转化为沉浸式3D交互网页
- Connects Instruction files the AI reads
- Account or key No key found in README or SKILL.md
- Category Other
For makers: add a badge to your README
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/skills/andyhuo520-aetherviz-master)Similar Skills
Same kind of work, ordered like the Skills list
| This one aetherviz-master | llmfit | claude-video | VideoCaptioner | claude-cookbooks | |
|---|---|---|---|---|---|
| Maker | andyhuo520 | AlexsJones | bradautomates | WEIFENG2333 | anthropics |
| Skills | 1 | 1 | 1 | 1 | 4 |
| GitHub stars | 1,680 | 39,036 | 21,085 | 16,557 | 54,799 |
| Last code change | Apr 20, 2026 | Nov 16, 2026 | Sep 25, 2026 | Sep 12, 2026 | Nov 5, 2026 |
| License | MIT | MIT | MIT | GPL-3.0 | MIT |
1 skills (instruction sets) by andyhuo520 that an AI reads and follows · not an MCP server
How a Skill differs from MCP
MCP = the hands
Connects the AI to an outside service or data, such as reading Notion or creating an invoice. A program or server has to be running.
Skill = the manual
A text file that teaches the AI how to do a task. It connects to nothing.
Some overlap: a few Skills run scripts that call tools, and a few MCP servers only send knowledge. Start from the task you want done.
Works with
Claude Code
From the maker’s README and the folders in the repo
Install
Is it safe?
- Who made it
GitHub account andyhuo520 (person), 2 years old
- Use and upkeep
★ 1,680 stars · code last changed Apr 20, 2026
- Any scripts?
No, plain text files the AI reads and follows
- Uses the internet?
No scripts, so it does not go online by itself
- Changes machine-wide settings?
No hooks or writes to machine settings found
Checked automatically from the repo files at commit a1c005f (read only, nothing was run). Not a safety guarantee: read it and decide for yourself
First: which AI do you use?
Pick your app and this page shows only how to install it there
Option 1Upload to claude.ai (web and app)
Files are byte-for-byte the same as on GitHub at commit a1c005f · View on GitHub ↗
Plain text files, no programs
Once uploaded it runs on Claude’s systems, not on your computer. No need to unzip
Look inside before downloading
All 3 files · 20 KB
LICENSE1 KBREADME.md7 KBSKILL.md11 KB
Download aetherviz-master.zip
Open Skills on claude.ai and upload
+Create skillUpload a skillpick aetherviz-master.zip
No Upload button? Turn on file creation first
SettingsCapabilitiesCode execution and file creation
Turn on Code execution and file creation first (newer menus: Create and edit files) · personal plans: Settings → Capabilities · Team/Enterprise: an admin turns it on under Organization settings → Plugins & skills · every plan, including Free
Upload once; it works in claude.ai and Claude Desktop, and in recent Claude Code signed in with a Claude account (not with an API key)
Cowork and cloud sessions use the skills turned on in your claude.ai account, not ~/.claude/skills on your computer (Claude Desktop scheduled tasks run locally and still load it)
Checked against official docs Nov 12, 2026 · Source: support.claude.com, support.claude.com, code.claude.com
Option 1Let Claude Code install it
Copy this sentence and paste it into a Claude Code chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Restart Claude Code, then type /aetherviz-master or ask for a matching task and Claude picks it up
Checked against official docs Nov 12, 2026 · Source: code.claude.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.claude/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/andyhuo520/aetherviz-master.git /tmp/popnx-skill-andyhuo520-aetherviz-master-a1c005f && mkdir -p ~/.claude/skills && cp -R '/tmp/popnx-skill-andyhuo520-aetherviz-master-a1c005f/.' ~/.claude/skills/aetherviz-masterRestart Claude Code, then type /aetherviz-master or ask for a matching task and Claude picks it up
ChatGPT desktop app
The ChatGPT desktop app has Codex built in, and Codex reads skills from ~/.agents/skills
Option 1Let ChatGPT install it
Open Codex in the ChatGPT desktop app and paste this sentence into the chat
The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Option 2Put the folder there yourself
Put the aetherviz-master folder at ~/.agents/skills/aetherviz-master
~ is your home folder ($HOME)
Without Terminal: download the ZIP, unzip it and move the aetherviz-master folder to ~/.agents/skills
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.agents/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/andyhuo520/aetherviz-master.git /tmp/popnx-skill-andyhuo520-aetherviz-master-a1c005f && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-andyhuo520-aetherviz-master-a1c005f/.' ~/.agents/skills/aetherviz-master
After installing
- ChatGPT desktop app: open Skills in the sidebar to see that the skill is there
- To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name
- Codex picks up newly installed skills by itself; if one does not show up, restart Codex
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
ChatGPT on the web and mobile
Skills you install yourself do not work here; only skills that come with a plugin from the directory
To use this skill with ChatGPT, use the ChatGPT desktop app as above
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
Option 1Let Codex install it
Copy this sentence and paste it into a Codex chat · Works in Codex inside the ChatGPT desktop app, Codex CLI and the IDE extension
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Codex picks up newly installed skills by itself; if one does not show up, restart Codex · To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.agents/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/andyhuo520/aetherviz-master.git /tmp/popnx-skill-andyhuo520-aetherviz-master-a1c005f && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-andyhuo520-aetherviz-master-a1c005f/.' ~/.agents/skills/aetherviz-masterRestart Codex, then ask for a matching task; Codex lists the skill
Option 1Let Cursor install it
Copy this sentence and paste it into a Cursor chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
In Cursor’s Agent chat, type / and pick aetherviz-master
Checked against official docs Nov 12, 2026 · Source: cursor.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.cursor/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/andyhuo520/aetherviz-master.git /tmp/popnx-skill-andyhuo520-aetherviz-master-a1c005f && mkdir -p ~/.cursor/skills && cp -R '/tmp/popnx-skill-andyhuo520-aetherviz-master-a1c005f/.' ~/.cursor/skills/aetherviz-masterIn Cursor’s Agent chat, type / and pick aetherviz-master
Option 1Let the AI install it
For other apps that read skills. The sentence gives the paths for Claude Code, Codex and Cursor so the AI picks the one for your app · Copy this sentence into the app’s chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Checked against official docs Nov 12, 2026 · Source: code.claude.com, learn.chatgpt.com, cursor.com
For Terminal users
Other apps that support Agent Skills (such as Gemini CLI or GitHub Copilot) use different folders. Check that app’s guide, then copy the folder with the SKILL.md there.
Skill folders checked against the official Claude Code, Codex and Cursor guides on Nov 11, 2026
✓ Commands checked Nov 18, 2026
View the original SKILL.md
The text below comes from the maker’s repo, not from PopNx MCP
Showing the first 8,000 characters · Open the full file on GitHub
---
name: aetherviz-master
description: AetherViz Master - 互动教育可视化建筑师,将任意教学主题转化为极致美观、高度交互的专业教学网页
---
# AetherViz Master —— 互动教育可视化建筑师
**版本**: 5.0 (SVG + Three.js 融合版)
**创建日期**: 2026-02-22
**核心使命**: 把用户输入的任意教学主题瞬间转化为沉浸式3D交互教学网页
---
## 核心配色方案 (Professional Teal-Cyan Theme)
### 主色调系统
```css
/* 核心渐变 - 从青绿到天蓝 */
--primary-gradient: linear-gradient(135deg, #14B8A6 0%, #06B6D4 50%, #22D3EE 100%);
--primary-gradient-light: linear-gradient(135deg, #2DD4BF 0%, #5EEAD4 50%, #67E8F9 100%);
--primary-gradient-dark: linear-gradient(135deg, #0D9488 0%, #0891B2 50%, #0EA5E9 100%);
/* 背景渐变 - 深海科技感 */
--bg-gradient: linear-gradient(180deg, #0F172A 0%, #164E63 50%, #155E75 100%);
--bg-gradient-card: linear-gradient(145deg, rgba(20, 184, 166, 0.15) 0%, rgba(6, 182, 212, 0.1) 100%);
/* 强调色 - 霓虹质感 */
--accent-cyan: #22D3EE;
--accent-emerald: #34D399;
--accent-amber: #FBBF24;
--accent-rose: #FB7185;
--accent-orange: #FB923C;
/* 主题色 - 根据学科自动切换 */
--theme-physics: linear-gradient(135deg, #3B82F6 0%, #0EA5E9 100%); /* 蓝色物理 */
--theme-chemistry: linear-gradient(135deg, #F59E0B 0%, #EF4444 100%); /* 橙红化学 */
--theme-biology: linear-gradient(135deg, #10B981 0%, #22D3EE 100%); /* 翠绿生物 */
--theme-math: linear-gradient(135deg, #F59E0B 0%, #EAB308 100%); /* 金黄数学 */
--theme-astronomy: linear-gradient(135deg, #1E40AF 0%, #3B82F6 100%); /* 深蓝天文 */
--theme-programming: linear-gradient(135deg, #22C55E 0%, #14B8A6 100%); /* 代码青 */
/* 玻璃拟态 */
--glass-bg: rgba(255, 255, 255, 0.08);
--glass-border: rgba(255, 255, 255, 0.15);
--glass-shadow: 0 8px 32px rgba(0, 0, 0, 0.3);
/* 文字颜色 */
--text-primary: #F8FAFC;
--text-secondary: #CBD5E1;
--text-muted: #94A3B8;
/* 功能色 */
--success: #22C55E;
--warning: #F59E0B;
--error: #EF4444;
--info: #3B82F6;
```
### UI 组件配色
```css
/* 导航栏 */
--nav-bg: rgba(15, 23, 42, 0.85);
--nav-border: rgba(20, 184, 166, 0.3);
/* 侧边栏 */
--sidebar-bg: rgba(15, 23, 42, 0.9);
--sidebar-item-hover: rgba(20, 184, 166, 0.2);
--sidebar-item-active: rgba(6, 182, 212, 0.4);
/* 控制面板 */
--panel-bg: rgba(22, 78, 99, 0.7);
--panel-border: rgba(20, 184, 166, 0.25);
/* 按钮 */
--btn-primary: linear-gradient(135deg, #14B8A6 0%, #06B6D4 100%);
--btn-primary-hover: linear-gradient(135deg, #2DD4BF 0%, #22D3EE 100%);
--btn-secondary: rgba(255, 255, 255, 0.1);
/* 滑块 */
--slider-track: rgba(255, 255, 255, 0.2);
--slider-thumb: linear-gradient(135deg, #2DD4BF 0%, #5EEAD4 100%);
```
---
## 技术栈要求
### 必须通过 CDN 引入
1. **Three.js r134** (稳定版)
```
https://cdnjs.cloudflare.com/ajax/libs/three.js/r134/three.min.js
```
2. **OrbitControls** - 必须内联完整简化版代码
- 包含 enableDamping
- 支持 touch 操作
- 支持 zoom 限制
3. **Tailwind CSS v3.4+**
```
https://cdn.tailwindcss.com
```
4. **KaTeX** (公式渲染)
```html
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/katex.min.css">
<script src="https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/katex.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/katex@0.16.11/dist/contrib/auto-render.min.js"></script>
```
5. **字体**: Inter + 系统 sans-serif
6. **D3.js** (可选,用于数据驱动 SVG)
```
https://d3js.org/d3.v7.min.js
```
---
## SVG + Three.js 混合渲染方案
### 自动识别逻辑
根据主题内容自动判断使用哪种渲染方案:
| 主题特征 | 推荐方案 | 说明 |
|----------|----------|------|
| 需要空间感、立体结构 | Three.js 纯 3D | 分子结构、机械运动、天体 |
| 2D 图表、函数图像 | SVG Overlay | 函数曲线、统计图、流程图 |
| 既有 3D 又有数据图表 | Three.js + SVG | 混合模式(默认推荐) |
| 几何证明、作图 | SVG 优先 | 勾股定理、三角函数 |
| 物理模拟、粒子效果 | Three.js 纯 3D | 运动轨迹、碰撞 |
| 复杂流程 + 3D 对象 | Three.js + SVG | 混合模式 |
### 混合渲染架构
```javascript
// 1. Three.js 3D 场景(底层)
const scene = new THREE.Scene();
const renderer = new THREE.WebGLRenderer({ alpha: true });
// 2. SVG Overlay(顶层,透明背景)
const svgContainer = document.createElement('div');
svgContainer.style.cssText = 'position:absolute;top:0;left:0;width:100%;height:100%;pointer-events:none;';
document.getElementById('canvas-container').appendChild(svgContainer);
const svg = d3.select(svgContainer).append('svg')
.attr('width', '100%')
.attr('height', '100%');
// 3. 坐标同步
function syncSVGto3D() {
const vector = new THREE.Vector3(x, y, z);
vector.project(camera);
const sx = (vector.x * 0.5 + 0.5) * width;
const sy = (-(vector.y * 0.5) + 0.5) * height;
return { x: sx, y: sy };
}
```
### SVG 适用场景
| 场景 | SVG 元素 | 示例 |
|------|----------|------|
| 函数图像 | `<path>` | 三角函数波形 |
| 坐标系网格 | `<line>` | X/Y 轴 |
| 数据图表 | `<rect>`, `<circle>` | 柱状图、散点图 |
| 标注箭头 | `<marker>` | 指示箭头 |
| 图例 | `<g>` + `<text>` | 颜色图例 |
| 流程图 | `<rect>` + `<path>` | 步骤流程 |
| 刻度标注 | `<text>` | 刻度数字 |
### 响应式同步
- 滑块控制 → 同时更新 Three.js 对象属性 + SVG 路径/d 属性
- 3D 相机移动 → SVG 标注位置实时跟随(使用 projectVector)
- 窗口 resize → 同步更新 SVG viewBox 和 Three.js renderer
---
## 输出规则 (100%严格遵守)
### 1. 输出格式
- **只能**输出一个完整的 HTML 文件
- 从 `<!DOCTYPE html>` 开始,到 `</html>` 结束
- **绝不添加任何解释、说明、markdown、代码块**
### 2. 零依赖
- HTML 必须**零依赖外部文件**
- 可直接保存为 `lesson.html` 并用浏览器打开就能完美运行
- 支持手机触控
### 3. 页面结构
#### 顶部导航栏
- 左侧大标题(主题名称 + 中英文)
- 右侧按钮:「重置」「随机实验」「全屏」「关于」
- 背景:`--nav-bg`
- 底部边框:`--nav-border`
#### 左侧边栏 (30%宽度,可折叠)
- 学习目标(3-4条,带复选框)
- 核心公式/概念(KaTeX实时渲染,多行对齐)
- 原理文字解释(生动比喻、高中-大学水平)
- "为什么重要" + 真实世界应用 + 扩展阅读链接
#### 中央主区域 (70%)
- Three.js 3D 画布(全响应式)
- 背景渐变:使用 `--bg-gradient`
#### 底部/右侧控制面板
- 玻璃拟态风格
- 实时滑块(质量、力、浓度等)+ 数值显示
- KaTeX 计算结果
- 播放/暂停/单步/速度倍率
- 「随机实验」按钮
#### 小测验面板 (可折叠设计)
- **必须支持一键隐藏/展开**
- 默认显示在右侧区域
- 右上角必须有「隐藏」按钮 (✕ 或 icon)
- 隐藏后显示为**右下角圆形悬浮按钮**(带 quiz 图标)
- 点击悬浮按钮可重新展开面板
- 面板展开/收起带平滑过渡动画 (transition: all 0.3s ease)
- 面板尺寸:宽度 360px,最大高度 380px
- 定位:右侧底部,控制面板上方或并列
---
## Three.js 教学模块要求
### 场景核心
```javascript
THREE.Scene() + PerspectiveCamera(fov:60, near:0.1, far:1000) + WebGLRenderer(antialias:true, shadowMap.enabled:true)
```
### 灯光系统
- HemisphereLight(环境光)
- DirectionalLight(主光源,castShadow=true)
### 材质与模型
- MeshStandardMaterial / MeshPhongMaterial
- 金属度、粗糙度可调
- 生物/化学使用透明材质 + 粒子
### 矢量可视化
- THREE.ArrowHelper
- 动态长度、颜色渐变:
- 力:红色 (#EF4444)
- 速度:蓝色 (#3B82F6)
- 加速度:绿色 (#22C55E)
### 粒子系统
- THREE.Points + BufferGeometry + PointsMaterial
- 支持实时更新 position/color attribute
### 轨迹线
- THREE.Line + BufferAttribute
- 固定长度缓冲区,每帧 shift 并 push 新点
### 物理模拟
- 内联 Verlet 积分或 Euler 方法
- 使用 THREE.Clock deltaTime
### 交互增强
- THREE.Raycaster + mouse 事件
- 点击 3D 物体高亮 + 侧边栏弹出公式推导
### 标签系统
- THREE.Sprite + CanvasTexture 或 DOM 元素
- 使用 projectVector 同步
---
## 视觉与交互要求
### 风格
- 赛博教育风 / 玻璃拟态 + 霓虹强调色
- 根据主题自动切换配色:
- 物理:蓝色渐变
- 化学:橙红渐变
- 生物:翠绿渐变
- 数学:金黄渐变
- 天文:深蓝渐变
- 编程:代码青渐变
### 动画
- 60fps 丝滑
- 所有变化带 spring 缓动与物理感
### 响应式
- 变量实时响应:滑块移动 → 3D物体变化 + 矢量箭头同步伸缩 + SVG HUD 更新
- 支持手机:触摸旋转、双指缩放、长按物体显示提示
---
## 教育性要求
### 语言风格
- 亲切鼓励、零门槛但严谨专业
- 每处交互即时反馈(Toast提示 + 高亮解释 + 3D高光)
### 功能
- 包含「重置到初始状态」按钮
- 包含「随机实验」按钮
- 自动检测中文/英文主题并用对应语言输出
### HTML 结尾
- 添加一句鼓舞的话
- 添加「由 AetherViz Master 为你生成 ❤️」
---
## 执行流程
### 当用户输入主题时:
1. **接收主题**
- 用户输入:任意教学主题(物理、数学、化学、生物、天文、编程概念等)
- 示例:「牛顿第二定律」「光合作用」「勾股定理」「正弦函数」「DNA复制」
2. **自动检测分析**
- **学科识别**:根据关键词识别学科领域(物理/化学/生物/数学/天文/编程)
- **渲染方案识别**:根据主题特征判断使用 Three.js 纯 3D / SVG 2D / 混合模式
- **自动选择配色主题**
```javascript
// 渲染方案自动识别逻辑
function detectRenderMode(topic) {
const threeKeywords = ['运动', '粒子', '碰撞', '旋转', '天体', '分子', '机械', '力', '磁场', '电场'];
const svgKeywords = ['函数', '图像', '曲线', '图表', '统计', '证明', '几何', '坐标'];
const hybridKeywords = ['牛顿', '运动定律', '波动', '振动', '电磁', '能量'];
const hasThree = threeKeywords.some(k => topic.includes(k));
const hasSVG = svgKeywords.some(k => topic.includes(k));
const hasHybrid = hybridKeywords.some(k => topic.includes(k));
if (hasHybrid || (hasThree && hasSVG)) return 'hybrid';
if (hasSVG) return 'svg';
return 'three';
}
```
3. **生成 HTML**
- 严格按照上述规范生成完整的单文件 HTML
- 根据渲染模式决定是否包含 SVG/D3.js
- 确保 Three.js 场景正确配置
- 确保 KaTeX 公式正确渲染
- 混合模式下自动创建 SVG overlay 层
4. **输出**
- 直接输出 HTML 代码
- 不添加任何说明
---
## 示例主题
### Three.js 纯 3D 场景
- 牛顿第二定律
- 光合作用
- DNA复制
- 电磁感应
- 相对论时间膨胀
- 量子隧穿效应
- 行星运动定律
- 细胞呼吸
### SVG 2D 图表
- 勾股定理
- 三角函数
- 正弦函数图像
- 概率分布
- 统计图表
### 混合模式Discussion
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
From GitHub
- GitHub stars
- 1,680
- Maker
- andyhuo520
- License
- MIT
- Last code change
- Apr 20, 2026
- SKILL.md files in the repo (including translated copies and templates)
- 1