Skip to content

ResourceLearning

ResourceLearning

ResourceLearning is a pedagogical spec type generated by the Curator Agent from open educational resources (OER). It indexes the resource with a 3-dimension qualityScore that evaluates its suitability for a specific curricular context.

Use Cases

Source	Tool	Output
CK-12 FlexBook (JSON)	`curator curate --source-type OER_RESOURCE`	`ResourceLearning`
Khan Academy (JSON/API)	`curator curate --source-type OER_RESOURCE`	`ResourceLearning`
Procomún / INTEF (MEC)	`docs discover --source mec-procomun` + batch	`ResourceLearning`
Europeana Education	`docs discover --source europeana-edu` + batch	`ResourceLearning`

YAML Schema

apiVersion: core.oas.colabedu.io/v1beta1
kind: ResourceLearning
metadata:
  name: <referenceCode>          # e.g.: global.res.ck12.bio.mitosis.v1
  displayName: "<Resource title>"
  description: "<Pedagogical description>"
  tags:
    - biology
    - open-education
    - ck12

spec:
  source:
    url: "https://www.ck12.org/biology/mitosis/"
    provider: "ck12"             # ck12 | khan-academy | mec-procomun | europeana-edu
    title: "Mitosis — CK-12 Biology FlexBook"
    license: "CC BY-NC 3.0"
    language: "en"
    contentType: "article"       # article | video | interactive | lesson | quiz
    importedAt: "2026-06-09T00:00:00Z"

  qualityScore:
    # Scale 0.0 – 1.0 per dimension
    alignment: 0.85              # alignment with the provided CurricularContext
    pedagogicalRichness: 0.70    # variety of activities and content depth
    accessibility: 0.60          # multilingual support, WCAG, alternative formats
    # Overall = weighted average (alignment×0.5 + richness×0.3 + accessibility×0.2)
    overall: 0.76

  applicableStandards:
    - "es.lomloe.bach.1.bio"
    - "us.ap.biology"

  curricularContext:
    standard: LOMLOE
    level: "1 BACH"
    subject: "biology"
    referenceCode: "es.lomloe.bach.1.bio"

Field Reference

`spec.source`

Field	Type	Description
`url`	`string`	Canonical URL of the resource
`provider`	`string`	Provider ID: `ck12`, `khan-academy`, `mec-procomun`, `europeana-edu`
`title`	`string`	Original title of the resource
`license`	`string`	Resource license (e.g., `CC BY-NC 3.0`, `CC BY 4.0`)
`language`	`string`	ISO 639-1 language code
`contentType`	`enum`	`article` \| `video` \| `interactive` \| `lesson` \| `quiz`

`spec.qualityScore`

The curator_resource Gem evaluates each resource using a 3-dimension rubric:

Dimension	Weight	What it evaluates
`alignment`	50%	How well the content aligns with the `CurricularContext` (standard, level, subject)
`pedagogicalRichness`	30%	Variety of activities, conceptual depth, progressive scaffolding
`accessibility`	20%	Multilingual support, subtitles, WCAG 2.1 AA, alternative formats

The overall field is the weighted average. Resources with overall < 0.5 are flagged as status: LOW_QUALITY and excluded from teacher recommendations.

`spec.applicableStandards[]`

List of curricular standard referenceCode values applicable to the resource. This enables the SpecManager recommendation engine to filter relevant resources for a specific course.

CLI Ingestion

# Single OER resource in sandbox
curator curate \
  --source ce-specs/sources/oer/ck12/ck12_bio_mitosis_smoke.json \
  --source-type OER_RESOURCE \
  --output-type RESOURCE_LEARNING \
  --sandbox

# Batch from Procomún
docs discover --source mec-procomun --subject language --output mec.yaml
docs download --list mec.yaml --local-dir ce-specs/sources/oer/mec-procomun/
curator batch --manifest ce-specs/tests/lms_batch_manifest.yaml

# OER tests
curator test --lms --case ck12_oer_bio_resource
curator test --lms --all --threshold 70

Environment Variables for OER Sources

Variable	Source
`COLABEDU_API_KEY_EUROPEANA`	Europeana Education API (wskey)
`COLABEDU_API_KEY_CANVAS`	Canvas Commons API token

Sources ck12, khan-academy, and mec-procomun do not require an API key.