Semantic KM Creator
Turn an interface contract—REST/OpenAPI, CLI, or table/DDL—into a governed semantic layer in four
strictly sequential phases. Advance only when the current phase meets its exit condition.
Phase 1 Ingest → Phase 2 Review → Phase 3 Emit → Phase 4 Verify
ingest.md review.md emit-okf.md verify.md
emit-yaml.md
The interface is the sole source of truth. Never invent fields, grain, enums, or values. Stop on
missing evidence and ask one question at a time.
Workflow
- Ingest (
references/ingest.md) — Normalize interfaces into a complete operation inventory
and classify each operation as fact or dimension lookup with read/write status. Exit when every
operation is classified.
- Review (
references/review.md) — Decompose the model into atomic decisions. Show objective,
options, evidence, risks, dependencies, and tradeoffs, with fixed YAGNI guidance for facts,
dimensions, measures, and routing. Inject model JSON into assets/review-template.html; record
feedback in amendments.md and regenerate. Stop after the report. Exit only on approved:true
with no open or blocked decisions.
- Emit — Default to a Google OKF v0.1 bundle using
references/emit-okf.md; use repository
YAML only when explicitly requested, following references/emit-yaml.md. Both targets share
field semantics. Generate a thin root index for two or more bundles. Exit when every artifact
exists.
- Verify (
references/verify.md) — Run structural checks, semantic lint, and OKF hard
constraints when applicable. Report every pass and failure. Return non-mechanical failures to
Phase 2 with one blocking question.
Critical Rules
- Evidence only — Unsupported fields, grain, enums, or values become
TODO(verify) and an open
decision.
- Grain first — Attach no dimensions or measures before grain is fixed.
- One blocking ask — Stop only when an answer changes the model; ask one question with options.
Use the HTML review for bulk decisions.
- Layer split — Shape, routing, and grain belong to the semantic layer. Values typed into
commands or read from responses—enums, codes, paths, and commands—belong to the contract layer;
the semantic layer only points to them.
- Stable names — Do not rename confirmed fact or dimension names; OKF concept IDs derive from
paths.
- Decision gate — Every decision starts pending. Phase 2 must stop after producing the report;
Phase 3 requires
approved:true and no open or blocked item.
Load by phase: ingest.md, review.md, emit-okf.md or emit-yaml.md, then verify.md. Read
references/examples.md for an end-to-end example.
1---2name: semantic-km-creator-23description:4 Builds evidence-only Kimball semantic layers from REST/OpenAPI, CLI, or table/database interfaces5 through an HTML decision workbench, then emits Google OKF or repository YAML. Use for enterprise6 knowledge modeling, semantic layers, dimensional models, ontology, or OKF.7license: Apache-2.08metadata:9 source: https://skillmd.com/skills/ontology-of-everything/semantic-km-creator-210 language: en11 translation_of: semantic-km-creator-cn12 version: "0.6.0"13 openclaw:14 homepage: https://github.com/ontology-of-everything/concept-skills/tree/main/skills/en/semantic-km-creator15---1617# Semantic KM Creator1819Turn an interface contract—REST/OpenAPI, CLI, or table/DDL—into a governed semantic layer in four20strictly sequential phases. Advance only when the current phase meets its exit condition.2122```text23Phase 1 Ingest → Phase 2 Review → Phase 3 Emit → Phase 4 Verify24 ingest.md review.md emit-okf.md verify.md25 emit-yaml.md26```2728The interface is the sole source of truth. Never invent fields, grain, enums, or values. Stop on29missing evidence and ask one question at a time.3031## Workflow32331. **Ingest** (`references/ingest.md`) — Normalize interfaces into a complete operation inventory34 and classify each operation as fact or dimension lookup with read/write status. Exit when every35 operation is classified.362. **Review** (`references/review.md`) — Decompose the model into atomic decisions. Show objective,37 options, evidence, risks, dependencies, and tradeoffs, with fixed YAGNI guidance for facts,38 dimensions, measures, and routing. Inject model JSON into `assets/review-template.html`; record39 feedback in `amendments.md` and regenerate. Stop after the report. Exit only on `approved:true`40 with no open or blocked decisions.413. **Emit** — Default to a Google OKF v0.1 bundle using `references/emit-okf.md`; use repository42 YAML only when explicitly requested, following `references/emit-yaml.md`. Both targets share43 field semantics. Generate a thin root index for two or more bundles. Exit when every artifact44 exists.454. **Verify** (`references/verify.md`) — Run structural checks, semantic lint, and OKF hard46 constraints when applicable. Report every pass and failure. Return non-mechanical failures to47 Phase 2 with one blocking question.4849## Critical Rules50511. **Evidence only** — Unsupported fields, grain, enums, or values become `TODO(verify)` and an open52 decision.532. **Grain first** — Attach no dimensions or measures before grain is fixed.543. **One blocking ask** — Stop only when an answer changes the model; ask one question with options.55 Use the HTML review for bulk decisions.564. **Layer split** — Shape, routing, and grain belong to the semantic layer. Values typed into57 commands or read from responses—enums, codes, paths, and commands—belong to the contract layer;58 the semantic layer only points to them.595. **Stable names** — Do not rename confirmed fact or dimension names; OKF concept IDs derive from60 paths.616. **Decision gate** — Every decision starts pending. Phase 2 must stop after producing the report;62 Phase 3 requires `approved:true` and no open or blocked item.6364Load by phase: `ingest.md`, `review.md`, `emit-okf.md` or `emit-yaml.md`, then `verify.md`. Read65`references/examples.md` for an end-to-end example.