skilld
All skills
microsoft avatar

/ontology-school-path-generator

@9523d07
by microsoftmicrosoft/ontology-playground2.8k stars
362

Generate Ontology School course paths/labs with progressive step ontologies from source ontology material. Use when user asks to tutorialize an ontology into school lessons and per-step builds.

Ask your Agent

Use this Skill: https://skilld.dev/gh/microsoft/ontology-playground/ontology-school-path-generator

This session only. Nothing lands on disk.

SKILL.md

≈56 tokens always: the name and description. ≈438 when used: this file. ≈120 more on demand in 1 file.

Ontology School Path Generator Skill

Goal

Generate a complete Ontology School course with progressive ontology steps.

Read First

  1. docs/authoring-guide.md
  2. docs/learn-content-guide.md
  3. docs/embed-guide.md
  4. Example lab:
  • content/learn/iq-lab-retail-supply-chain/
  • catalogue/official/iq-lab-retail-step-1/

Workflow

  1. Extract a teachable subset from source ontology.
  2. Define step progression (4-7 steps).
  3. Create step ontologies under catalogue/official/<slug>-step-N/.
  4. Mark step ontologies with "category": "school".
  5. Create course under content/learn/<course-slug>/.
  6. Add <ontology-embed> + diff for progressive steps.
  7. Include at least one quiz per article.

Person Names

If the course, step ontologies, examples, sample data, quests, quiz text, or docs need any person names, first use the name-generator skill. Do not invent customer, employee, patient, student, instructor, reviewer, or other human names.

All generated person names must come from:

data/reference/FNF-2026-06-01-01002-0268.csv

Use the CSV FullName column by default, and keep selected names consistent across source markdown, RDF/OWL examples, generated catalogue data, and tests.

Validate

  • npm run qa:tutorial-content
  • npm run build

Human Review Flow

If lesson content is not yet approved:

  • Add reviewStatus: under-human-review to article frontmatter
  • Open review issue via .github/ISSUE_TEMPLATE/ontology-school-review.yml

Done Criteria

  • Course renders in /#/learn
  • Step ontologies are isolated in School category
  • Any person names introduced by the lesson or sample data came from the name-generator skill / approved CSV fixture
  • Builds and validators pass

Source: SKILL.md on GitHub

Third-party checks

No alerts2mo3 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    This skill generates educational modules from ontologies using structured workflows. It includes quality assurance steps, such as automated build scripts and a human review process, to ensure content accuracy and safety. The skill also follows privacy best practices by using a predefined data source for name generation.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: LOW · No issues

Provenance

Signed by skilld at 9523d07. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 weeks ago.

Activeupdated 4 months ago

README badge

README badge for microsoft/ontology-playground/ontology-school-path-generator