Repolode
withmarbleapp

withmarbleapp/os-taxonomy

An open, structured graph of what primary-school children learn: 1,591 micro-topics linked by prerequisites and aligned to national curriculum standards.

Stars
5,981
Forks
992
Open issues
17
Last commit
18 hours ago

What is it?

This dataset maps what children learn across the primary and elementary years. It breaks curriculum content into fine-grained micro-topics, each with a plain-language description, mastery evidence criteria, a topic type, a subject and domain, and an approximate age range. Topics are connected by 3,225 directed prerequisite edges, so a learner's required foundations can be traced.

Each micro-topic links to the curriculum standards it was derived from, including NGSS, Common Core and the UK National Curriculum. The release covers eight subjects, led by Science and Mathematics. A separate teaching-research file adds teaching approaches, activities and assessment guidance for part of the Science and Mathematics topics.

The data is distributed as plain JSON with checksums and validation scripts, and needs no runtime. Its database is under ODbL 1.0 and its authored text under CC BY-SA 4.0, while upstream curriculum standards keep their own licenses.

Key features

  • 01Provides 1,591 micro-topics with descriptions, evidence criteria and age ranges.
  • 02Connects topics with 3,225 prerequisite dependencies that include strength and a reason.
  • 03Links topics to standards from NGSS, Common Core and the UK National Curriculum.
  • 04Includes teaching research for part of the Science and Mathematics topics.
  • 05Ships as plain JSON with manifest checksums and validation scripts.

Use cases

  • Mapping prerequisite paths for a learning app or adaptive tutoring system.
  • Aligning lesson or assessment content to specific national curriculum standards.
  • Analyzing how primary-school concepts depend on one another in edtech research.
  • Building a curriculum visualization or teacher-facing topic browser.

Quick start

  1. 1

    Clone the repository

  2. 2

    Load the JSON files in data/ directly in your code (no install needed)

  3. 3

    Optionally validate the data structure and checksums

    node scripts/validate.mjs

Things to know

  • Teaching research covers only Science and Mathematics; 540 topics have no research in this release.
  • Teaching activities are research-informed proposals, not empirically validated interventions.
  • Source claims were not re-verified for this release.
  • Licensing is split: the database is ODbL 1.0 and content is CC BY-SA 4.0, and curriculum standards follow their own upstream licenses.

Topics

FAQ

What is os-taxonomy?
An open, structured graph of what primary-school children learn: 1,591 micro-topics linked by prerequisites and aligned to national curriculum standards. This dataset maps what children learn across the primary and elementary years. It breaks curriculum content into fine-grained micro-topics, each with a plain-language description, mastery evidence criteria, a topic type, a subject and domain, and an approximate age range. Topics are connected by 3,225 directed prerequisite edges, so a learner's required foundations can be traced.
Is os-taxonomy free to use? What license does it have?
os-taxonomy is open source under the ODbL-1.0 license. Check the license terms before using it in commercial products.
Is os-taxonomy still maintained?
Actively maintained. The last commit to os-taxonomy was on Oct 19, 2026.
What can I use os-taxonomy for?
Mapping prerequisite paths for a learning app or adaptive tutoring system. Aligning lesson or assessment content to specific national curriculum standards. Analyzing how primary-school concepts depend on one another in edtech research. Building a curriculum visualization or teacher-facing topic browser.
How do I install os-taxonomy?
Clone the repository Load the JSON files in data/ directly in your code (no install needed) Optionally validate the data structure and checksums: node scripts/validate.mjs
Where can I get os-taxonomy?
The source code and installation instructions are on GitHub: https://github.com/withmarbleapp/os-taxonomy

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects