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.):

1. Copy skill/SKILL.md (English) or skill/SKILL_CN.md (Chinese) to your AI assistant's skill directory
2. Copy the data/ directory alongside it — it contains knowledge trees, exercises, error banks, and concept graphs for all 9 subjects
3. Start a conversation:

   Create an interactive courseware for "Photosynthesis" (Grade 7 Biology)
   

4. 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:

1. Copy admin-skillhub-package/SKILL.md to your AI assistant's skill directory
2. Set GITHUB_TOKEN environment variable
3. Start a conversation:

   Create a "Pythagorean Theorem" (Grade 8 Math) courseware and push it to the official Gallery
   

4. 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

1. Clone this repo
2. Open any examples/*/index.html in your browser
3. 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 ⭐}