# anthropics/k12-teacher-skills architecture

> Architecture diagram of the GitHub repository anthropics/k12-teacher-skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anthropics/k12-teacher-skills
- Repository: https://github.com/anthropics/k12-teacher-skills

## Overview

This repository packages four Claude skills for K–12 teachers, rather than a standalone lesson-generation service. Teachers request lesson creation, differentiation, lesson preparation, or a math formative check; the skills guide Claude through those distinct educational tasks, with optional Learning Commons Knowledge Graph guidance. Lesson-plan creation and differentiation also support rendering generated lesson documents as HTML previews and editable DOCX files. The renderer relationships follow the sampled scripts; skill behavior is based on README descriptions and skill paths, whose full source was not sampled.

Main entry points: [`plugin/skills/k12-lesson-plan-creation/scripts/render_documents.py`](https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-plan-creation/scripts/render_documents.py) (Plan Document Batch), [`plugin/skills/k12-lesson-differentiation/scripts/render_documents.py`](https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-differentiation/scripts/render_documents.py) (Differentiation Batch), [`plugin/skills/k12-lesson-plan-creation/SKILL.md`](https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-plan-creation/SKILL.md) (Lesson Planning), [`plugin/skills/k12-lesson-differentiation/SKILL.md`](https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-differentiation/SKILL.md) (Lesson Differentiation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_skills["Teacher Skills"]
  node_lesson_plan["Lesson Planning<br/>[SKILL.md]"]
  node_differentiate["Lesson Differentiation<br/>[SKILL.md]"]
  node_lesson_prep["Lesson Preparation<br/>[SKILL.md]"]
  node_understanding["Understanding Check<br/>[SKILL.md]"]
end

subgraph group_render["Document Rendering"]
  node_plan_batch["Plan Document Batch"]
  node_diff_batch["Differentiation Batch"]
  node_plan_html["Plan HTML Renderer"]
  node_plan_docx["Plan DOCX Renderer"]
  node_diff_html["Differentiation HTML Renderer"]
  node_diff_docx["Differentiation DOCX Renderer"]
end

subgraph group_shared["Shared Rendering Layer"]
  node_plan_common["Plan Content Helpers<br/>[lesson_common.py]"]
  node_diff_common["Differentiation Content Helpers<br/>[lesson_common.py]"]
end

node_teacher(("Teacher"))
node_knowledge_graph{{"Learning Commons KG"}}
node_plan_output["Lesson Documents"]
node_diff_output["Tiered Documents"]
node_prep_output["Prep Note"]
node_check_output["Formative Check"]

node_teacher -->|"requests lesson"| node_lesson_plan
node_teacher -->|"requests adaptation"| node_differentiate
node_teacher -->|"requests preparation"| node_lesson_prep
node_teacher -->|"requests check"| node_understanding
node_lesson_plan -.->|"consults standards"| node_knowledge_graph
node_differentiate -.->|"consults standards"| node_knowledge_graph
node_understanding -.->|"consults standards"| node_knowledge_graph
node_lesson_plan -->|"produces plan"| node_plan_output
node_differentiate -->|"produces tiers"| node_diff_output
node_lesson_prep -->|"produces prep note"| node_prep_output
node_understanding -->|"produces assessment"| node_check_output
node_plan_batch -->|"renders HTML"| node_plan_html
node_plan_batch -->|"renders DOCX"| node_plan_docx
node_diff_batch -->|"renders HTML"| node_diff_html
node_diff_batch -->|"renders DOCX"| node_diff_docx
node_plan_html -->|"uses helpers"| node_plan_common
node_plan_docx -->|"uses helpers"| node_plan_common
node_diff_html -->|"uses helpers"| node_diff_common
node_diff_docx -->|"uses helpers"| node_diff_common
node_plan_batch -->|"writes documents"| node_plan_output
node_diff_batch -->|"writes documents"| node_diff_output

click node_lesson_plan "https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-plan-creation/SKILL.md"
click node_differentiate "https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-differentiation/SKILL.md"
click node_lesson_prep "https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-prep/SKILL.md"
click node_understanding "https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-check-for-understanding/SKILL.md"
click node_plan_batch "https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-plan-creation/scripts/render_documents.py"
click node_diff_batch "https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-differentiation/scripts/render_documents.py"
click node_plan_html "https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-plan-creation/scripts/render_lesson_html.py"
click node_plan_docx "https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-plan-creation/scripts/render_lesson_docx.py"
click node_diff_html "https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-differentiation/scripts/render_lesson_html.py"
click node_diff_docx "https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-differentiation/scripts/render_lesson_docx.py"
click node_plan_common "https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-plan-creation/scripts/lesson_common.py"
click node_diff_common "https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-differentiation/scripts/lesson_common.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_lesson_plan,node_differentiate,node_lesson_prep,node_understanding toneBlue
class node_plan_batch,node_diff_batch,node_plan_html,node_plan_docx,node_diff_html,node_diff_docx toneAmber
class node_plan_common,node_diff_common toneMint
class node_teacher,node_knowledge_graph,node_plan_output,node_diff_output,node_prep_output,node_check_output toneIndigo
```

## Components

### Teacher Skills

- [Lesson Planning](https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-plan-creation/SKILL.md): `plugin/skills/k12-lesson-plan-creation/SKILL.md`
- [Lesson Differentiation](https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-differentiation/SKILL.md): `plugin/skills/k12-lesson-differentiation/SKILL.md`
- [Lesson Preparation](https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-prep/SKILL.md): `plugin/skills/k12-lesson-prep/SKILL.md`
- [Understanding Check](https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-check-for-understanding/SKILL.md): `plugin/skills/k12-check-for-understanding/SKILL.md`

### Document Rendering

- [Plan Document Batch](https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-plan-creation/scripts/render_documents.py): `plugin/skills/k12-lesson-plan-creation/scripts/render_documents.py`
- [Differentiation Batch](https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-differentiation/scripts/render_documents.py): `plugin/skills/k12-lesson-differentiation/scripts/render_documents.py`
- [Plan HTML Renderer](https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-plan-creation/scripts/render_lesson_html.py): `plugin/skills/k12-lesson-plan-creation/scripts/render_lesson_html.py`
- [Plan DOCX Renderer](https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-plan-creation/scripts/render_lesson_docx.py): `plugin/skills/k12-lesson-plan-creation/scripts/render_lesson_docx.py`
- [Differentiation HTML Renderer](https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-differentiation/scripts/render_lesson_html.py): `plugin/skills/k12-lesson-differentiation/scripts/render_lesson_html.py`
- [Differentiation DOCX Renderer](https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-differentiation/scripts/render_lesson_docx.py): `plugin/skills/k12-lesson-differentiation/scripts/render_lesson_docx.py`

### Shared Rendering Layer

- [Plan Content Helpers](https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-plan-creation/scripts/lesson_common.py): `plugin/skills/k12-lesson-plan-creation/scripts/lesson_common.py`
- [Differentiation Content Helpers](https://github.com/anthropics/k12-teacher-skills/blob/main/plugin/skills/k12-lesson-differentiation/scripts/lesson_common.py): `plugin/skills/k12-lesson-differentiation/scripts/lesson_common.py`

### Other components

- **Teacher**
- **Learning Commons KG**
- **Lesson Documents**
- **Tiered Documents**
- **Prep Note**
- **Formative Check**

## Connections

- Teacher → Lesson Planning: requests lesson
- Teacher → Lesson Differentiation: requests adaptation
- Teacher → Lesson Preparation: requests preparation
- Teacher → Understanding Check: requests check
- Lesson Planning → Learning Commons KG: consults standards
- Lesson Differentiation → Learning Commons KG: consults standards
- Understanding Check → Learning Commons KG: consults standards
- Lesson Planning → Lesson Documents: produces plan
- Lesson Differentiation → Tiered Documents: produces tiers
- Lesson Preparation → Prep Note: produces prep note
- Understanding Check → Formative Check: produces assessment
- Plan Document Batch → Plan HTML Renderer: renders HTML
- Plan Document Batch → Plan DOCX Renderer: renders DOCX
- Differentiation Batch → Differentiation HTML Renderer: renders HTML
- Differentiation Batch → Differentiation DOCX Renderer: renders DOCX
- Plan HTML Renderer → Plan Content Helpers: uses helpers
- Plan DOCX Renderer → Plan Content Helpers: uses helpers
- Differentiation HTML Renderer → Differentiation Content Helpers: uses helpers
- Differentiation DOCX Renderer → Differentiation Content Helpers: uses helpers
- Plan Document Batch → Lesson Documents: writes documents
- Differentiation Batch → Tiered Documents: writes documents