Every school, every teacher, every parent — build your own Khan Academy for every child, at zero cost.
Turn any K-12 topic into an interactive, evidence-based learning experience — in minutes, with AI.
简体中文 · Live Gallery · Getting Started · Methodology · Contributing
/install-skill https://github.com/weponusa/teachany-opensource
国内用户请使用 Gitee 镜像（无需翻墙，高速访问）：
/install-skill https://gitee.com/weponusa/teachany
详细安装指南：
- 🌐 国际用户：See Getting Started
- 🇨🇳 国内用户：查看 一键安装指南（推荐）
What's included: 7 subjects (Math, Physics, Chemistry, Biology, History, Geography, Chinese), 178+ high-quality teaching materials, aligned with 2022 curriculum standards.
Most AI-generated educational content looks like this:
📝 Here are 5 key points about quadratic functions...
📋 Quiz: What is the vertex of y = x² + 2x + 1?
A) (1, 0) B) (-1, 0) C) (0, 1) D) (-1, 1)
Flat. Lifeless. No pedagogy. Students get a wall of text with a multiple-choice quiz slapped on the end. No motivation, no scaffolding, no error diagnosis, no learning loop.
TeachAny is not a prompt template — it's a complete instructional design system that embeds 6+ learning science theories into AI-generated courseware:
| Dimension | Generic AI | TeachAny |
|---|---|---|
| Lesson Structure | Random bullet points | ABT Narrative (And-But-Therefore) |
| Assessment | "Correct ✓ / Wrong ✗" | Per-option error diagnosis ("You flipped the sign of h") |
| Difficulty | One-size-fits-all | 3-level scaffolding (full → partial → none) |
| Subject Adaptation | Same template for everything | 9 subject-specific frameworks |
| Theoretical Foundation | None | 6+ learning science theories |
| Interaction | Click next → read more | Canvas simulations, drag-and-drop, concept tests |
|
ABT Narrative Structure Every module opens with And (what you know) → But (the gap) → Therefore (why this lesson matters). |
Bloom's Taxonomy Exercises span all 6 cognitive levels: Remember → Understand → Apply → Analyze → Evaluate → Create. |
ConcepTest (Mazur) Concept-check questions designed for 30-70% accuracy — the sweet spot for peer discussion. |
|
Cognitive Load Theory (Sweller) ~75 words per card. One core question per module. New concept → immediate example. |
Mayer's Multimedia Principles Contiguity, signaling, segmenting, pre-training — applied to every layout decision. |
Scaffolding Strategy Level 1: template/fill-in → Level 2: hints only → Level 3: independent work. |
Click any course below to experience it live:
| Course | Subject | Grade | Interactions | Lines |
|---|---|---|---|---|
| 📐 Quadratic Functions | Math | Grade 9 | Canvas graphing, vertex dragging, step-by-step derivation | 1,300+ |
| 📏 Linear Functions | Math | Grade 8 | Slope/intercept sliders, real-time graph | 1,100+ |
| 📚 Congruent Triangles | Math | Grade 8 | SVG geometry diagrams, theorem comparison, proof scaffolding | 1,200+ |
| 🧬 Meiosis & Fertilization | Biology | Grade 10 | Cell division simulation, chromosome drag-and-drop | 1,400+ |
| 🌍 Global Monsoon Systems | Geography | Grade 10 | Leaflet map, wind pattern visualization, region comparison | 1,200+ |
| 💧 Liquid Pressure & Buoyancy | Physics | Grade 8 | Experiment simulation, parameter adjustment | 1,000+ |
| 🌿 Photosynthesis | Biology | Grade 7 | Canvas animation, drag-and-drop equation, TTS narration | 1,950+ |
| ⚡ Ohm's Law | Physics | Grade 9 | Virtual circuit lab, V-I graphing, formula derivation, TTS narration | 2,630+ |
| 🔤 Compound Vowels | Chinese | Grade 1 | Phonics audio, mouth-shape cues, guided pronunciation practice | 800+ |
All courses are single-file HTML — no build step, no dependencies. Open in any browser.
TeachAny works as a Skill for AI coding assistants (CodeBuddy, Cursor, Windsurf, Claude, etc.):
- Copy
skill/SKILL.md(English) orskill/SKILL_CN.md(Chinese) to your AI assistant's skill directory - Copy the
data/directory alongside it — it contains knowledge trees, exercises, error banks, and concept graphs for all 9 subjects - Start a conversation:
Create an interactive courseware for "Photosynthesis" (Grade 7 Biology) - The AI will follow TeachAny's methodology to produce a complete, interactive HTML courseware
Note: The skill only needs
skill/+data/. Official and community coursewares are available on the TeachAny Gallery website — they are NOT bundled with the skill.
If you maintain the TeachAny repository and want to generate and publish official courseware:
- Copy
admin-skillhub-package/SKILL.mdto your AI assistant's skill directory - Set
GITHUB_TOKENenvironment variable - Start a conversation:
Create a "Pythagorean Theorem" (Grade 8 Math) courseware and push it to the official Gallery - The AI will generate the courseware, validate quality, pack, publish to GitHub Releases, and push to Git — all automatically
cp -r examples/_template my-new-course
# Edit my-new-course/index.html with your content
open my-new-course/index.html
- Clone this repo
- Open any
examples/*/index.htmlin your browser - Modify the content for your own lesson
TeachAny follows a structured 4-phase workflow:
Phase 0: Define Phase 1: Design Phase 2: Adapt Phase 3: Build
┌─────────────┐ ┌──────────────────┐ ┌──────────────────┐ ┌────────────────┐
│ Answer the │ │ ABT narrative │ │ Subject-specific │ │ HTML/CSS/JS │
│ 6 Questions │───▶│ Content audit │───▶│ framework │───▶│ Interactive │
│ (who, what, │ │ Prerequisite │ │ Five-lens method │ │ courseware │
│ why, how) │ │ chain │ │ Scaffolding │ │ + Assessment │
└─────────────┘ └──────────────────┘ └──────────────────┘ └────────────────┘
Before any code is written, TeachAny requires answering:
| # | Question | Purpose |
|---|---|---|
| 1 | Who are the students? | Determines difficulty and language |
| 2 | What prerequisites? | Decides if pre-test is needed |
| 3 | What should they be able to DO? | Turns "knowing" into observable tasks |
| 4 | What real-world scenario? | Provides learning motivation |
| 5 | Where do students get stuck? | Drives error diagnosis design |
| 6 | How to verify they learned? | Determines assessment strategy |
TeachAny doesn't use one-size-fits-all. Each subject has its own:
| Subject | Teaching Approach | Interaction Type | Assessment Style |
|---|---|---|---|
| Math | Visual intuition + algebraic reasoning + generalization | Graphing, dragging, step-by-step derivation | Standard + explanation questions |
| Physics | Observation + modeling + quantitative analysis | Parameter sliders, experiment prediction | Prediction + calculation + explanation |
| Biology | Structure → process → function | Labeling, sorting, flowchart puzzles | Diagram + process explanation |
| Geography | Spatial distribution → cause → regional comparison | Map interaction, chart reading, causal chains | Material analysis + comparison |
| History | Timeline → causation → evidence → multiple perspectives | Sorting, source comparison, stance analysis | Source-based + essay questions |
| Chinese | Close reading → expression techniques → theme transfer | Annotation, rewriting, imitation writing | Annotation + writing tasks + rubric |
| English | Input → scaffolded output → contextual application | Dialogue cards, fill-in, role-play | Integrated skills assessment |
| Chemistry | Macro phenomenon → micro explanation → symbolic representation | Experiment flow, equation balancing | Experiment explanation + structured response |
| IT | Task-driven + step-by-step demo + debugging | Click operations, flowcharts, code execution | Task completion + process check |
For any difficult concept, select 2-3 lenses:
👁️ See It → Observe phenomena, examples, data
🔧 Break It → Decompose structure, steps, components
💡 Explain It → Clarify cause, mechanism, rules
⚖️ Compare It → Contrast with similar/opposite/wrong examples
🎯 Transfer It → Apply to new contexts to verify understanding
teachany/
├── README.md # English README (this file)
├── README_CN.md # Chinese README
├── LICENSE # MIT License
├── CONTRIBUTING.md # Contribution guide (bilingual)
├── CHANGELOG.md # Version history
├── index.html # Gallery homepage (dynamically loads courseware)
├── courseware-registry.json # 📋 Courseware registry (metadata index)
│
├── skill/
│ ├── SKILL.md # English Skill definition
│ └── SKILL_CN.md # Chinese Skill definition
│
├── admin-skillhub-package/
│ ├── SKILL.md # Admin Skill (generate + validate + pack + publish)
│ └── README.md # Admin Skill documentation
│
├── data/ # 📚 Knowledge Layer
│ ├── README.md # Architecture document
│ ├── schema.md # JSON schema specification
│ ├── chinese/ # Chinese Language
│ │ └── pinyin/ # Pinyin (graph, errors, exercises)
│ └── math/ # Mathematics
│ └── functions/ # Functions (graph, errors, exercises)
│
├── docs/
│ ├── methodology.md # Deep dive into learning theories
│ ├── getting-started.md # Step-by-step guide
│ ├── design-system.md # Visual design specification
│ └── subject-guides/ # Per-subject usage guides
│
├── examples/ # 🌐 Official coursewares (website only, NOT part of skill)
│ ├── math-quadratic-function/ # Quadratic functions (Math, Grade 9)
│ ├── math-linear-function/ # Linear functions (Math, Grade 8)
│ ├── math-congruent-triangles/# Congruent triangles (Math, Grade 8)
│ ├── bio-meiosis/ # Meiosis (Biology, Grade 10)
│ ├── bio-photosynthesis/ # Photosynthesis (Biology, Grade 7)
│ ├── geo-monsoon/ # Monsoon systems (Geography, Grade 10)
│ ├── phy-ohms-law/ # Ohm's Law (Physics, Grade 9)
│ ├── phy-pressure-buoyancy/ # Pressure & buoyancy (Physics, Grade 8)
│ ├── chn-compound-vowel/ # Compound vowels (Chinese, Grade 1)
│ └── _template/ # Starter templates (elementary/middle/high)
│
├── community/ # 🌐 Community courseware index
│ └── index.json
│
├── scripts/
│ ├── registry-loader.js # 🔄 Gallery dynamic loader (renders cards from registry)
│ ├── courseware-importer.js # 📥 Courseware importer (.teachany/.zip/.html)
│ ├── community-loader.js # 🌐 Community courseware loader
│ ├── pack-courseware.cjs # 📦 Courseware packing tool
│ ├── publish-courseware.cjs # 🚀 Publish to GitHub Releases + update registry
│ ├── bootstrap-courseware.cjs # 🏆 Knowledge layer data extraction
│ ├── validate-courseware.cjs # ✅ 18-point courseware quality check
│ └── knowledge_layer.py # Audit + on-demand retrieval CLI
│
├── dist/ # 📦 Build output (.gitignore'd)
│
└── .github/
├── ISSUE_TEMPLATE/
└── workflows/
TeachAny uses a code-courseware separation architecture:
| Layer | Storage | Content | Size Budget |
|---|---|---|---|
| Code | Git repo | Skill definitions, knowledge layer, scripts, templates | < 50 MB |
| Metadata | courseware-registry.json | Course name, subject, grade, links | < 100 KB |
| Courseware | GitHub Releases | .teachany packages (HTML + audio + video) | Unlimited |
# Dry-run: pack all courseware without uploading
node scripts/publish-courseware.cjs --all --dry-run
# Publish a single courseware to GitHub Releases
GITHUB_TOKEN=ghp_xxx node scripts/publish-courseware.cjs ./examples/math-linear-function
# Publish all courseware
GITHUB_TOKEN=ghp_xxx node scripts/publish-courseware.cjs --all
All TeachAny courseware shares a consistent visual language:
/* Core color tokens */
--bg: #0f172a; /* Primary background */
--card: rgba(30,41,59,0.7); /* Glassmorphism cards */
--primary: #3b82f6; /* Blue: main accent */
--secondary: #8b5cf6; /* Purple: secondary accent */
--accent: #f59e0b; /* Yellow: highlights */
--success: #10b981; /* Green: correct */
--danger: #ef4444; /* Red: incorrect */
- Typography: 16px body, 1.7-1.8 line-height
- Cards: Semi-transparent glassmorphism (
backdrop-filter: blur(10px)), 16px border-radius - Grid:
repeat(auto-fit, minmax(300px, 1fr))responsive grid - Formulas: Times New Roman, accent color
| Document | Description |
|---|---|
| Getting Started | Create your first course in 5 minutes |
| Methodology | Deep dive into all 6+ learning science theories |
| Design System | Visual specification and CSS variables |
| Subject Guides | Per-subject best practices |
We welcome contributions! See CONTRIBUTING.md for guidelines.
Ways to contribute:
- 🎓 Create a new course — Pick any K-12 topic and build an interactive courseware
- 📚 Expand the Knowledge Layer — Add knowledge graphs, error databases, and exercise banks for any subject (see
data/schema.md) - 🌐 Translate — Help translate the Skill or documentation to your language
- 🐛 Report issues — Found a pedagogical error or UI bug? Let us know
- 📝 Improve docs — Better examples, clearer explanations, more subject guides
- 🎨 Design components — Reusable quiz engines, interactive widgets, visualizations
The following frameworks and methods are original creations of the TeachAny project:
| Contribution | Description |
|---|---|
| Five-Lens Method | A 5-perspective approach (See It → Break It → Explain It → Compare It → Transfer It) for teaching difficult concepts |
| Subject Adaptation Matrix | 9 subject-specific teaching frameworks with tailored interaction types and assessment styles |
| 6-Question Pre-Design Framework | A structured pre-design checklist that ensures pedagogical completeness before any code is written |
| Lesson Type Classification | Systematic categorization (new concept / review / practice / thematic / lab) with corresponding structural templates |
| Phase 4 Review Checklist | A quality assurance protocol covering pedagogy, interaction, accessibility, and visual design |
| Visual Design System | A cohesive dark-theme glassmorphism design language optimized for educational content |
The TeachAny Skill prompt and all associated documentation are released under MIT License. You may use, modify, and redistribute them freely.
TeachAny's methodology is grounded in peer-reviewed learning science:
| Theory | Original Work |
|---|---|
| ABT Narrative | Olson, R. (2015). Houston, We Have a Narrative. University of Chicago Press. |
| Cognitive Load Theory | Sweller, J. (1988). Cognitive load during problem solving. Cognitive Science, 12(2), 257-285. |
| Multimedia Learning | Mayer, R.E. (2009). Multimedia Learning (2nd ed.). Cambridge University Press. |
| ConcepTest / Peer Instruction | Mazur, E. (1997). Peer Instruction: A User's Manual. Prentice Hall. |
| Bloom's Taxonomy | Anderson, L.W. & Krathwohl, D.R. (2001). A Taxonomy for Learning, Teaching, and Assessing. |
| Scaffolding | Wood, D., Bruner, J.S., & Ross, G. (1976). The role of tutoring in problem solving. Journal of Child Psychology and Psychiatry, 17(2), 89-100. |
MIT License — see LICENSE for details.
Built with ❤️ for teachers and students everywhere.
If TeachAny helps you create better learning experiences, give us a ⭐
