SkillFoxx

AutoPPT skill

A skill that builds a course week: three interactive HTML decks with notes, practice code and a student edition.

  • 57 ★ on the repository
  • Last commit
  • MIT
Skill

Extended access

Why this level

  • The skill runs scripts and practice Python code and reaches the network for sources and images.
All reasons and checks

xingjunm/autopptAuthor:xingjunm

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/autoppt

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The skill runs scripts and practice Python code and reaches the network for sources and images.

This is third-party code. Review the repository files before installing.

What it does

The teacher names a topic or provides a syllabus, and the agent follows a fixed workflow to build a week of material: two theory lectures and one practice session. These are 16:9 slides of about 45 minutes, each with a detailed speaker script opened with the `S` key. Slides embed interactive examples that compute in the browser, and the practice code, outputs and Jupyter Notebook come from one real run. A student edition without notes, a teacher guide with a minute-by-minute plan, a student guide and pages with fact and image sources are built automatically. Three visual styles are available.

Who it is for. University and school teachers who want to hand layout, speaker notes and code to an agent and focus on course content.

Good fit when

  • You need a week of lectures and practice from one sentence or a syllabus.
  • Slides must be interactive: a viewer drags a slider and the result computes on the spot.
  • The practice session needs code that was actually run and matches the students' notebook.
  • The course lives in git and a number must be changed with one edit and a rebuild.

Not a fit when

  • You need a PowerPoint file to hand over.
  • The computer cannot install Python, Node.js and Chromium for checks.
  • You need a ten-minute deck with no notes and no code.

Example request

Build week one: an introduction to artificial intelligence, two lectures and a practice session.

Limitations

Building needs Python 3.9 or newer and Node.js 18 or newer with Playwright and Chromium for checks and screenshots. Practice sessions need libraries such as NumPy, pandas or scikit-learn, which the agent can install. In Codex the sandbox blocks the network by default, so image search and dependency installs need approval. Every fact is checked against sources online, which takes time. The README shows a clone URL with a placeholder instead of the owner; substitute `xingjunm`. The course came out of real teaching and targets a university level.

How to disable. Delete `~/.claude/skills/autoppt` or `~/.agents/skills/autoppt`. Generated courses remain ordinary folders you delete by hand.

FAQ

How do I install it?

Clone the repository and run `python3 install.py --agent claude` for Claude Code, `--agent codex` for Codex or `--agent both` for both.

How do I install it for one course?

Add `--project` and the course folder path, for example `python3 install.py --agent codex --project <folder>`.

Which styles are available?

Three: academic journal, dark stage and geometric colour blocks. The style can be changed later.

Where can I see an example?

`examples/week01` holds a full week-one kit; run `python3 start.py` in that folder and the browser opens.

What do I get?

Slides with notes, a student edition, teacher and student guides, a notebook and source pages.

Discussion

No questions or reviews yet.

Skills

Dashi PPT

Dashi PPT Skill

A skill that turns a document into a deck: a browser-editable HTML presentation with a per-page console and export to PPTX and PDF

SkillExtended access10.7K

A skill that turns a scientific paper PDF or a numbered outline into a finished .pptx with sharp formulas and figures.

SkillExtended access123

A skill that builds presentations from HTML slides with rendering, per-slide visual review, and conversion to an editable PPTX

SkillExtended access5.2K

A skill that turns an article, report or notes into a deck of full-slide images and assembles them into a pptx

SkillExtended access7.8K10

A skill for talks: outlines a deck around the audience's train of thought, picks images and video, and checks finished slides before you present

SkillExtended access993

A skill for dependency-free HTML presentations: style picked from live previews and PowerPoint converted to the web

SkillExtended access32.3K

README in short

This is a skill plus a slide engine shared by Claude Code and Codex. The Codex variant is built from `SKILL.codex.md` and adds sandbox hints.

README badge

Original SKILL.md

---
name: autoppt
description: AutoPPT（AI备课神器）——只需一句话的课程主题（或一份教学大纲），先了解老师的课程需求，再一键生成一整周精美、可交互的 HTML 教学课件（两节理论课 + 一节实践课，各约 45 分钟）：完整讲稿、浏览器里真实计算的互动、可直接运行的实践代码与 Notebook、学生版、教师指南与出处页；三种风格（学术刊物 / 黑底舞台 / 几何色块）任选。Use when a teacher asks to design / build / 做 / 设计 course slides or 课件, a weekly design doc (设计文档), lecture decks from a syllabus, or says "开干" after a design doc.
---

# AutoPPT（AI备课神器）：一周三节课的交互式 HTML 课件

你要交付的是**一整周可以直接上课的课件**：理论一、理论二、实践课三套 Reveal.js 幻灯片（1920×1080，离线可用），每页有完整讲稿，互动在浏览器里真实计算，实践课代码真实运行并生成 Notebook，另有学生版、教师指南、学生指南、事实出处与图片来源。

参考实现：仓库里的 `examples/week01/`（《人工智能基础》第 1 周，含设计文档）。动手前至少打开它的 `lecture1.html` 和 `第一周 设计文档.md` 看一遍。

## 什么时候用
- 老师第一次来、要做一门课 → 先 ⓪ 需求访谈、① 课程内容设计，老师确认后再做第 1 周。
- 一句话：“帮我做一节 / 一周关于 X 的课件” → **快速模式**：只问学生是谁和风格，其余用默认值，写设计文档并完整实现。
- “设计 / 做第 N 周的课件” → 写设计文档 **并完整实现**。
- “设计第 N 周的课程内容 / 设计文档” → **只写设计文档**；教师说“开干”再实现。
- “根据大纲做课件”“把这门课做成 HTML 课件” → 先建课程大纲与制作约定，再从第 1 周开始。

## 流程（详见 references/workflow.md）
**先了解老师的课，再做课件。** 前两步（⓪①）每门课只做一次，结果要老师确认。

⓪ **了解课程（需求访谈）**——`references/intake.md`、`templates/课程需求表.md`：先读老师给的大纲 / 教材目录 / 旧课件，再用选择题一轮最多 4 问补齐：学生是谁（会不会编程）、几周几节、每周讲什么、实践课做什么（编程 / 案例 / 实验 / 习题 / 写作）、配图政策（能否搜开放图库、能否 AI 生成、是否公开发布）、课件风格。快速模式（老师只说一句）只问学生和风格，其余用默认值并标“假设”。

① **课程内容设计**——产出 `课程大纲.md`（周次表：每周主题、三节课各讲什么、实践课形式、项目里程碑、每周主线、素材计划），**交老师修改确认**；同时建立《课件制作约定》。

**选风格**（在 ⓪ 中一并问）：给用户看 `styles/styles.jpg`，三选一（有选择题工具就用它，否则列编号选项）：
   - **A 学术刊物** `academic`（默认）：暖纸底 · 宋体大标题 · 整句标题 + 图证据
   - **B 黑底舞台** `stage`：深色封面与章节页 · 巨型年份 · 大字金句；内容页冷灰底
   - **C 几何色块** `blocks`：深蓝大色块 · 橙色圆点 · 网格信息；无衬线粗标题
   选定后写进《课件制作约定》，同一门课各周保持一致。

然后每一周：
1. **读**：课程大纲、`课件制作约定.md`、上一周的设计文档与结果、旧课件里**内容**对应的部分。
2. **设计文档**：按 `templates/周设计文档模板.md` 写《第 N 周 设计文档.md》——一句主线、逐页表、新组件、数据与计算、事实核查清单（联网核对）、验收标准、需要教师确认的事。教师修改后以修改版为准。
3. **生成骨架**：
   ```bash
   python3 <本 skill>/scripts/new_week.py --dest <课程文件夹> --week N --style academic --course "课程名" \
       --teacher "教师" --school "学校" --term "学期" --topic "本周主题" --l1 "理论一" --l2 "理论二" --lab "实践课"
   ```
   得到 `weekNN/`（风格写在 `src/styles/theme.css`；换风格 = 把 `src/styles/themes/` 里另一个文件复制过去）：页型样板（每种版式一页）、首页、学生指南、教师指南模板、`build.py`、`start.py`、`tools/run_lab.py`、`week.json`。上一周首页会自动加“第 N 周 →”。

Report a problem