mrkeyoor.com_
Sat 12 Sept 15:51 UTC
Dataevaluationupdated 12 Sept 2026

os-taxonomy review

Marble Skill Taxonomy is a set of JSON files that breaks primary and elementary learning into 1,590 small topics connected by 3,221 prerequisite links. It gives education products a starting map for deciding what a child may need to learn before moving to another concept.

Verdict

Our os-taxonomy run installed 0 packages in 10 seconds, but the repository exposed no build or test target for us to run. Use it as a well-labeled seed dataset if your team can review the graph and handle its layered licenses. Do not treat the 3,221 edges as classroom-ready truth merely because their IDs and checksums are internally consistent.

We ran it

Lab card: what happened when we ran os-taxonomyScreenshot of os-taxonomy (github.com/withmarbleapp/os-taxonomy)
Install✓ · 10s0 packages · 15 MB
Buildn/ano build script
Testsn/ano test script
Known vulns00 critical · 0 high · 0 moderate · 0 low (npm audit)
Repo20 files~103 lines of source · 9.2 MB · 0 CI workflows

Answers from our run

Does os-taxonomy build from source?

Dependencies installed in 10 seconds (0 packages), and the project has no separate build step. We cloned commit 96a7933 into a clean Debian container with 3 CPUs and no project-specific setup.

Does os-taxonomy have tests you can run?

Not through a standard command: the project exposes no test script or target that our harness could run.

Does os-taxonomy have known vulnerabilities in its dependencies?

npm audit found none in the dependency tree at the time of our run.

Who should not use os-taxonomy?

Teams that require expert-reviewed prerequisite edges out of the box: issue 5 flags five possible reversed or age-mismatched links, and issue 21 asks for a review-status field that the data does not have.

What are the alternatives to os-taxonomy?

Chinese K12 Taxonomy, XQ Competencies. Our os-taxonomy run installed 0 packages in 10 seconds, but the repository exposed no build or test target for us to run.

Setup5/510-second install, 0 dependencies, and plain JSON files
Docs5/5Schema, edge direction, licenses, attribution, and exclusions are clear
Community3/54,344 stars; 10 issues and 8 PRs, with August activity
Maturity3/5Version 1 has checksums, but no test target or review-status field

Who it’s for

Education developers who need a readable prerequisite graph instead of a flat standards list.
Tutoring teams prepared to audit each topic, edge, age range, and assessment prompt before use.
Researchers who want stable topic IDs and links to several national curriculum frameworks.
Commercial products that can follow ODbL, CC BY-SA, attribution, and upstream curriculum terms.

Who it’s NOT for

Teams that require expert-reviewed prerequisite edges out of the box: issue 5 flags five possible reversed or age-mismatched links, and issue 21 asks for a review-status field that the data does not have.
Products that need every standard's full official text: NGSS, C3, and IB sources are codes-only, while Common Core text has purpose-limited terms.
Organizations unwilling to share changes to the taxonomy itself: derivative databases fall under ODbL, and Marble's authored text uses CC BY-SA 4.0.
Developers expecting an npm library, API, or bundled application: the package is private and contains pure JSON plus a validation script.
Systems that need embeddings or learner records in the download: the manifest explicitly excludes embeddings and child mastery data.

Setup reality

Our npm install succeeded in 10 seconds, added 0 packages, and left 15 MB on disk. There was no build script or target, so build was skipped. There was also no test script or target, so tests were skipped. Npm audit found 0 known vulnerabilities.

The usable product is UTF-8 JSON. It needs no credentials, database, hosted service, or runtime dependency. Consumers must load the files, substitute or remove the {{name}} placeholder in assessment prompts, and preserve attribution plus the upstream notices for any curriculum standards they use.

The checkout was 9.2 MB with 20 files and about 103 lines of source. It has a dependency-free structural validator, but no CI workflow, Dockerfile, or tests directory. That validator checks references, counts, checksums, and codes-only rules; product teams still need their own pedagogical review and integration tests.

Four JSON files hold 1,590 learning topics

Marble Skill Taxonomy packages 1,590 micro-topics, 3,221 prerequisite links, 3,261 curriculum standards, and 183 domain summaries. The topics span 8 subjects, from mathematics and science to life skills. Each topic can include an age range, a plain description, evidence of mastery, an assessment prompt, and links back to curriculum standards. The result is usable raw material for a tutor, pathway planner, standards browser, or research project.

There is very little application code to understand. Our commit 96a7933 checkout contained 20 files, about 103 lines of source, and 9.2 MB of data and supporting material. The package is marked private and publishes no runtime library. You import the JSON directly or transform it into your own store. That simplicity reduces setup work, though it also means search, graph traversal, user state, and presentation all belong to the consuming product.

The 3,221 edges pass structural checks, not teaching review

The included validator checks topic IDs, allowed types, edge endpoints, standard references, declared counts, codes-only sources, and SHA-256 checksums. It catches a dangling link or modified file. It does not assess whether one concept should precede another, whether an age band is right, or whether a topic name describes its content. Although the README calls the graph acyclic, the validation script we read does not contain a cycle check.

Our repository scan found 0 CI workflow files and no tests directory. That leaves the validator as a command consumers or maintainers must choose to run. Issue 5 reports five soft edges whose prerequisite age range sits entirely above the topic it unlocks. The reporter explicitly allows that the links may be intentional. Issue 21 proposes review metadata because the current schema cannot distinguish an unreviewed edge from one checked by a person or subject expert.

What happened when we ran it

Our sandbox ran npm install successfully in 10 seconds. It added 0 packages, and disk use ended at 15 MB. Npm audit reported 0 known vulnerabilities across all severity levels. This is the rare npm repository where installation tells you almost nothing about adoption cost because there is no dependency tree, server, or generated client to maintain. The data files themselves are the product.

Build was skipped because package.json has no build script or target. Tests were also skipped because it has no test script or target. The repository does expose npm run validate, but the lab result supplied for this review does not record that command as a build or test. No Dockerfile is present. A team can inspect all 20 files without container tooling, then add its own checks around the fields and curriculum slices it plans to ship.

Three license layers follow the data into your product

The database structure, IDs, and relationships use ODbL 1.0. Marble's authored names, descriptions, evidence, prompts, reasons, and summaries use CC BY-SA 4.0. A commercial product can use the graph, but a derivative database must remain open under ODbL, and adapted authored text carries the content license. The README supplies an attribution statement. Legal review still needs to match your actual transformations and redistribution model.

The 0-vulnerability npm audit says nothing about those content rights. Curriculum standards come from separate upstream frameworks. The repository ships full UK National Curriculum text under OGL v3.0 and full Common Core text under its purpose-limited public license. NGSS, C3, and IB entries are codes-only because their terms restrict redistribution. Provenance notices are part of the integration work, especially when an interface displays official text beside Marble-authored explanations.

Fourteen conflicting names need a data audit

Issue 11 identifies 14 topic records whose names appear to conflict with their descriptions, evidence, prompts, linked standards, and dependency reasons. Examples in the report include a topic named Ratio whose other fields concern operation priority, and an Understanding angles label attached to rectangle area. The issue remains open. These are user-reported findings rather than a full audit, but they are concrete enough to test before showing the affected records to learners.

Issue 22 raises a separate alignment question for mathematics at ages 9 and 10, based on the reporter's calculation. With 0 installed packages and no test target, consumers cannot rely on a conventional suite to settle either concern. Sample records across every subject and age band, verify high-impact edges with educators, and keep a local correction layer. Stable IDs help with that work as long as you record which dataset commit each correction targets.

July code and August issues show activity without releases

GitHub recorded the last repository push on July 8, 2026, the date of the tested commit. The latest issue activity was August 28, so discussion continued after the code stopped moving. The open queue contained 10 issues and 8 pull requests when checked. Several contributions propose new curricula, data fixes, or extra tooling, which suggests interest while also showing that changes had not entered the published dataset. GitHub's latest-release endpoint returned no release.

The repository still labels the taxonomy v1, while package.json and the changelog call the initial data release 1.0.0. Its 20-file size makes commit pinning straightforward even without a GitHub release artifact. We would use the dataset behind an explicit review boundary: structural validation first, educator sampling second, product tests last. If your team lacks that editorial capacity, a smaller official framework or a domain-specific competency set is safer than treating this graph as settled curriculum.

Alternatives

ProjectWhat it isPick it when
Chinese K12 TaxonomyA Chinese-language topic and prerequisite graph for grades 1 through 12.pick this instead when Chinese national curriculum coverage is the primary requirement.
XQ CompetenciesA CC BY 4.0 high-school competency framework with progression levels and research citations.pick this instead when high-school transferable skills matter more than elementary subject prerequisites.

What people are saying

  1. [github-trending] withmarbleapp/os-taxonomy

Sources

  1. Marble Skill Taxonomy README at tested commit
  2. Dataset manifest
  3. Dataset validation script
  4. Provenance and upstream licensing
  5. Issue 5: possible reversed edges
  6. Issue 11: topic-name conflicts
  7. Issue 22: mathematics alignment question
  8. GitHub repository metadata

More data reviews

Lean · bokeh · orm · datahub · open-source-games · lx-music-source · the whole board →