Labels, hierarchy and documentation for a controlled vocabulary, with Rock as the worked example and The Beatles never far away.
SKOS stands for Simple Knowledge Organization System. It is the W3C standard (2009) for publishing controlled vocabularies: flat lists, taxonomies and thesauri. It does not define classes of things. It describes concepts, the terms in your CBox, and how they are named, arranged and explained.
Two building blocks carry everything:
| Block | What it is | In the music domain |
|---|---|---|
skos:ConceptScheme | The vocabulary as a whole. One scheme, one purpose. | The Music genres vocabulary for your subgraph. |
skos:Concept | One unit of thought inside the scheme. Not a word: the idea the words point at. | Rock, whatever you call it and however you spell it. |
Every concept says which scheme it belongs to with skos:inScheme, and the scheme names its entry points with skos:hasTopConcept. Three families of properties do the rest, and this tutorial takes them in turn: labels what the concept is called, hierarchy where it sits, documentation what it means and how to use it.
A label is a string attached to a concept, always with a language tag. SKOS gives you three kinds, and the difference is not how good the word is. It is what the label is for.
| Property | Role | Rule | Rock |
|---|---|---|---|
skos:prefLabel display | The one term you show. The heading in the index, the tag on the record. | At most one per language. "Rock"@en and "Rockmusik"@de can both be preferred; two English ones cannot. | Rock@en · Rockmusik@de |
skos:altLabel also known as | Synonyms, other spellings, acronyms, older names. Real words people use and would expect to see. | As many as you like. Shown to users as "use for" or "see also". | Rock music@en · Rock (music)@en |
skos:hiddenLabel search only | Strings you want search to catch but never want to display: misspellings, typos, keyboard variants. | Never shown. Indexed. | Rok@en · Rcok@en · Rockmusic@en |
# Rock, labels only ex:rock a skos:Concept ; skos:prefLabel "Rock"@en, "Rockmusik"@de ; skos:altLabel "Rock music"@en, "Rock (music)"@en ; skos:hiddenLabel "Rok"@en, "Rcok"@en, "Rockmusic"@en .
Each string is about the concept Rock unless it is not. Pick the right home. One point each.
SKOS hierarchy is between concepts, not between classes of things. "Punk rock is narrower than Rock" says where the term sits in your vocabulary. It does not say every punk track is a rock track, and it does not have to.
| Property | Reads as | Rule |
|---|---|---|
skos:broader | "sits under". Rock has the broader concept Popular music: in the tree, Rock is indented beneath Popular music. | Inverses of each other. State one and a reasoner supplies the other, but a good file states both directions or picks one consistently. No cycles: a concept cannot be its own ancestor. |
skos:narrower | "has beneath it". Rock has the narrower concept Punk rock: the same tree edge, written from the parent's side. | |
skos:related | "see also". A sideways link between two concepts that are not above or below each other. Rock and Blues, the music it grew out of. | Symmetric. A pair of concepts cannot be both hierarchical and related. |
skos:topConceptOf | Marks the roots of the scheme, the concepts with nothing broader. | Pairs with skos:hasTopConcept on the scheme. |
Note the words: broader and narrower say nothing about why. Genre-within-genre, part-of, instance-of, all look the same. If you need to say "The Beatles are an instance of Rock band", that is the TBox and ABox talking, not SKOS. Keep people out of your genre vocabulary.
ex:rock
skos:broader ex:popular-music ;
skos:narrower ex:punk-rock, ex:hard-rock, ex:indie-rock ;
skos:related ex:blues, ex:rock-and-roll .
ex:punk-rock skos:broader ex:rock .
Eight genre words in the cloud, one empty tree below. Tap a word, then tap the slot where it sits. A right placement locks in and the word leaves the cloud. A wrong one bounces back and tells you why. One point per word placed right first time.
The tree is done. Which of these pairs deserve a skos:related link? Tick the ones that do, then check. Feedback only, no points.
A label names a concept. The documentation properties explain it. They are all sub-properties of skos:note, all plain text with a language tag, and each answers a different question. Filling them in is where the Module 2 quality checklist gets done.
| Property | Answers | Rock |
|---|---|---|
skos:definition | What is it? A complete statement of meaning. | A popular music genre that grew out of 1950s rock and roll, built on electric guitar, bass and drums, usually in 4/4. |
skos:scopeNote | When do I use it, and when not? The boundary. | Use for the genre from the mid-1960s onward. For the 1950s style it grew out of, use Rock and roll. |
skos:example | Show me one. | The Beatles, Abbey Road (1969). |
skos:historyNote | Where did the term come from? | Shortened from "rock and roll" during the 1960s as the music moved away from its dance-hall origins. |
skos:editorialNote | A note to the people maintaining the vocabulary. Not for the public. | Decide whether Classic rock is a genre or a radio format before the Module 4 review. |
skos:changeNote | What changed, when, by whom. | 2026-09-10: added Indie rock as a narrower concept. JT. |
skos:note | Anything that fits none of the above. | "Rock" is the same string in English and Spanish; each language gets its own preferred label. |
ex:rock
skos:definition "A popular music genre that grew out of 1950s rock and roll, built on electric guitar, bass and drums, usually in 4/4."@en ;
skos:scopeNote "Use for the genre from the mid-1960s onward. For the 1950s style it grew out of, use Rock and roll."@en ;
skos:example "The Beatles, Abbey Road (1969)."@en ;
skos:historyNote "Shortened from rock and roll during the 1960s."@en ;
skos:editorialNote "Decide whether Classic rock is a genre or a radio format."@en ;
skos:changeNote "2026-09-10: added Indie rock as a narrower concept. JT."@en .
Each snippet was written for one property. Which?
Here is the Rock concept written in Turtle with every value missing. The values are in the cloud. Tap a value, then tap the blank it belongs in. Labels, hierarchy and documentation all come back at once, and one value in the cloud belongs nowhere in a genre vocabulary.
ex:rock is the concept's identifier. a means "is a". Each line is one property and its value, ending in ; because the next line is about the same subject; the last line ends in . A value in quotes with @en is text in English. A value starting with ex: is another thing in your graph.Here is the Popular music slice from Section 3 as a complete, valid SKOS file: the scheme, its top concepts, every concept in the scheme, labels in two languages, both directions of the hierarchy, and documentation on the concept we worked on, Rock. Use it as the pattern for your subgraph's vocabulary.