explaingit

withmarbleapp/os-taxonomy

Analysis updated 2026-05-18

3,563JavaScriptAudience · researcherComplexity · 1/5LicenseSetup · easy

TLDR

An open dataset mapping 1,590 K-12 learning micro-topics into a prerequisite graph aligned to national curriculum standards.

Mindmap

mindmap
  root((Skill Taxonomy))
    What it does
      Learning micro topics
      Prerequisite graph
      Curriculum alignment
    Tech stack
      JSON data
      Node validator
    Use cases
      Curriculum tools
      Tutoring apps
      Education research
    Audience
      Researchers
      Edtech builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Build a curriculum planning or tutoring tool that needs a prerequisite graph of skills.

USE CASE 2

Map a student's mastered topics to figure out what they should learn next.

USE CASE 3

Align internal learning content to national curriculum standards like Common Core or NGSS.

USE CASE 4

Research how learning concepts depend on each other across subjects and ages.

What is it built with?

JSONNode.js

How does it compare?

withmarbleapp/os-taxonomyelecterious/basicscrollbenbjohnson/thesecretlivesofdata
Stars3,5633,6123,619
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasyeasyeasy
Complexity1/52/51/5
Audienceresearcherdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Pure JSON data with no runtime dependencies, just load the files directly.

The database structure is ODbL (commercial use allowed, attribution required, modified databases must stay open), Marble's written text is CC BY-SA (attribution plus share-alike), curriculum standards keep their own upstream licenses.

In plain English

Marble Skill Taxonomy is a dataset, not an application, that maps out what children learn during the primary and elementary school years. It breaks learning down into 1,590 small teachable ideas called micro topics, such as building sentences or understanding the apparent brightness of stars, and connects them with 3,221 prerequisite links that show what a learner needs to know before moving on to the next idea. Together these form a directed graph rather than a flat list of standards. Each micro topic includes a plain language description, criteria for how you would know a learner has mastered it, a type such as conceptual or procedural, a subject and domain, and an approximate age range. Each prerequisite link is marked as either a hard or soft dependency and comes with a one line reason explaining the connection. The topics are also mapped back to real curriculum standards, including NGSS, Common Core, and the UK National Curriculum, and grouped into 183 parent friendly summaries covering each subject, domain, and age range. Subjects covered include science, mathematics, English, history, personal and social development, life skills, computing, and learning to learn. All the data lives as plain JSON files, with a schema folder describing their structure and a manifest file listing counts and checksums for each file. There is no runtime or dependencies needed to use it: you simply load the JSON files in whatever language or tool you are working with. A small validation script written for Node.js checks that the structure and the internal references between topics are consistent. Licensing here is split into layers. The database itself, meaning the structure, identifiers, and relationships between topics, is under the Open Database License, which allows commercial use but requires attribution and that any modified version of the database itself stay open. The written text Marble created, like descriptions and explanations, is under Creative Commons Attribution ShareAlike. The curriculum standards data was extracted from outside sources and keeps its own original licenses, described separately. Building a product on top of this taxonomy does not require you to open source that product, only improvements made to the taxonomy itself.

Copy-paste prompts

Prompt 1
Show me how to load topics.json and dependencies.json to find all prerequisites for a given topic.
Prompt 2
Explain the difference between a hard and soft prerequisite dependency in this taxonomy.
Prompt 3
How do I validate the referential integrity of the Marble Skill Taxonomy data with the included script?
Prompt 4
What are the licensing rules if I build a commercial app on top of this taxonomy?

Frequently asked questions

What is os-taxonomy?

An open dataset mapping 1,590 K-12 learning micro-topics into a prerequisite graph aligned to national curriculum standards.

What language is os-taxonomy written in?

Mainly JavaScript. The stack also includes JSON, Node.js.

What license does os-taxonomy use?

The database structure is ODbL (commercial use allowed, attribution required, modified databases must stay open), Marble's written text is CC BY-SA (attribution plus share-alike), curriculum standards keep their own upstream licenses.

How hard is os-taxonomy to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is os-taxonomy for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.