# Ontology School Path Generator

> 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.

- Skill: `microsoft/ontology-school-path-generator` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add microsoft/ontology-school-path-generator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/microsoft/ontology-school-path-generator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Microsoft (https://skillmd.com/u/microsoft)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/microsoft/ontology-school-path-generator

---


# 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:

```text
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