Knowledge Graph Academy · Module 3 · SKOS · music genres

SKOS in One Sitting

Labels, hierarchy and documentation for a controlled vocabulary, with Rock as the worked example and The Beatles never far away.

four exercises along the wayscore 0/
1 · What SKOS is

The vocabulary you built in Module 2, written so a machine can read it

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:

BlockWhat it isIn the music domain
skos:ConceptSchemeThe vocabulary as a whole. One scheme, one purpose.The Music genres vocabulary for your subgraph.
skos:ConceptOne 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.

One idea, many wordsRecord shops, radio and streaming services file the same Beatles album under "Rock", "Rock music", "Rock (music)" and, in Germany, "Rockmusik". Four strings, one concept. SKOS lets you keep the one concept and hang every string off it, each with its proper role.
2 · Labels

Preferred, alternative, hidden

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.

PropertyRoleRuleRock
skos:prefLabel displayThe 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 asSynonyms, 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 onlyStrings you want search to catch but never want to display: misspellings, typos, keyboard variants.Never shown. Indexed.Rok@en · Rcok@en · Rockmusic@en
Two integrity rules worth memorisingA concept has at most one preferred label per language. And the three label sets do not overlap: a string that is a preferred label cannot also be an alternative or hidden label of the same concept. Checkers enforce both, and Section 5 will too.
# 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 .

Exercise · which label is it?

Each string is about the concept Rock unless it is not. Pick the right home. One point each.

3 · Hierarchy

Broader, narrower, related

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.

PropertyReads asRule
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:topConceptOfMarks 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.

  • Popular music top concept
    • Rock related: Blues, Rock and roll
      • Punk rock
      • Hard rock
      • Indie rock
    • Pop
    • Blues
    • Jazz
    • Rock and roll the 1950s style, its own concept
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 .

Exercise · put every word in its place

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.

0 of 8
4 · Documentation

Say what you mean, and what you meant by it

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.

PropertyAnswersRock
skos:definitionWhat 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:scopeNoteWhen 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:exampleShow me one.The Beatles, Abbey Road (1969).
skos:historyNoteWhere did the term come from?Shortened from "rock and roll" during the 1960s as the music moved away from its dance-hall origins.
skos:editorialNoteA 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:changeNoteWhat changed, when, by whom.2026-09-10: added Indie rock as a narrower concept. JT.
skos:noteAnything that fits none of the above."Rock" is the same string in English and Spanish; each language gets its own preferred label.
Definition versus scope noteThe definition says what the thing is. The scope note says what the term covers in this vocabulary. "Use for the genre from the mid-1960s onward" is not a definition of Rock; it is an instruction to the person tagging a record. Keep them apart and both get shorter.
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 .

Exercise · which note?

Each snippet was written for one property. Which?

5 · Fill in the Turtle

Put each value where it belongs in the RDF

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.

0 of 11
Reading the syntaxex: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.
6 · The whole scheme

Nine concepts, one scheme, everything wired

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.


    
Your turnTake the flat list your group made in Module 2. Pick five terms. For each: one preferred label per language, the synonyms as alternative labels, the typos you have seen as hidden labels, a broader concept or top-concept status, a definition and a scope note. Put them in one scheme. Then load the file into Ask the Graph and query for every concept whose broader is Popular music.