agentsclimarketplace

Taxonomy design

Skill jacob-balslev/skill-graph/marketplace/skills/taxonomy-design

Use when designing a controlled classification system: category trees, facets, browse taxonomies, SKOS broader/narrower relationships, tagging rules, and duplicate-category cleanup. Do NOT use for formal ontology axioms with reasoning constraints (use `ontology-modeling`), broad knowledge-representation choice (use `knowledge-modeling`), or one-off edge typing (use `semantic-relations`). Do NOT use for define OWL class restrictions and property domains for this knowledge base. Do NOT use for decide whether this knowledge should be represented as a graph, frame, rules, or hybrid. Do NOT use for type this single relation as meronymy, causality, synonymy, or thematic role. Do NOT use for write user-facing labels for this navigation item.From its SKILL.md

Install
npx -y skills add jacob-balslev/skill-graph --skill taxonomy-design

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

15.6 KB, ~2.5k tokens by cl100k_base, as published. Nobody here has run it

Taxonomy Design

Concept of the skill

Taxonomy design is the discipline of constructing a controlled classification system — a category tree (possibly augmented by facets) that organizes a set of items so they can be browsed, found, and reasoned about. Drawing from Ranganathan's faceted classification (PMEST: Personality, Matter, Energy, Space, Time), Aristotelian genus-species hierarchy, and the W3C SKOS data model, it treats classification as a retrieval contract between the system that organizes and the readers who navigate, not as a private mental map of the author.

Replaces ad-hoc category trees that mirror the author's mental map with classification systems designed for retrieval by the navigator. Solves the problem that the main failure mode of taxonomies is mixing incompatible organizing principles — categorizing by audience in one branch, by tool in another, by lifecycle phase in a third, by domain in a fourth, by risk in a fifth — producing a tree where related items scatter across distant branches and the navigator must learn the author's idiosyncratic grouping logic before finding anything. The discipline is to prefer shallow, stable, mutually understandable structure, add facets when one tree cannot express all valid access paths, and not turn every semantic relation into a hierarchy. Bowker & Star's Sorting Things Out documents how classifications without explicit retrieval-task analysis become abandoned bureaucratic structure — the lesson generalizes to every taxonomy in software (file folders, skill categories, navigation trees, tag systems, knowledge-graph categories).

Distinct from ontology-modeling, which owns formal axioms and reasoning semantics — this skill owns human-governed classification; ontology is formalization, taxonomy is organization. Distinct from knowledge-modeling, which chooses the representation paradigm (graph/frames/rules/hybrid) — this skill works inside the classification paradigm once chosen. Distinct from semantic-relations, which types individual concept edges (IS-A, PART-OF, thematic) — this skill governs the category system and assignment rules. Distinct from information-architecture, which arranges pages/navigation/labels/wayfinding for a user-facing experience — this skill is the underlying classification structure that information architecture surfaces. Distinct from folksonomies (emergent user tagging — different governance model with different trade-offs; folksonomies are bottom-up, taxonomies are top-down-controlled). Taxonomy design is to a knowledge surface what a public library's call-number system is to its collection — the books haven't changed, but the system determines which books a researcher finds when looking under 'biology' versus 'medicine' versus 'public health.' A library that categorizes by acquisition date (the author's mental map) is unfindable; one that categorizes by subject with cross-references and facet headings (retrieval contract for the navigator) is searchable. Dewey Decimal is a hierarchy with facet-like subdivisions; Library of Congress is more faceted; both are taxonomies, both have explicit retrieval-task analyses behind their structure. The wrong mental model is that taxonomy = hierarchy — that classification means choosing a tree and assigning items to it. It does not. Adjacent misconceptions: that deeper hierarchies are better organized (they are not — shallow trees with facets often outperform deep trees because the navigator scans fewer levels; Ranganathan's faceted classification is the alternative to strict hierarchies); that mixing organizing principles is fine (it is not — sibling categories must share the same organizing principle, or the navigator cannot predict where items will be; "by domain, then by tool, then by lifecycle" mixed within one tree produces unpredictable placement); that synonyms can be sibling categories (they cannot — synonyms must be aliases via skos:altLabel pointing to one canonical skos:prefLabel; otherwise the same concept duplicates and items split across both); that every semantic relation belongs in the hierarchy (it does not — related_to and other associative relations are not hierarchy; only IS-A passes the substitution test for parent-child placement); that catch-all "misc" buckets are acceptable (they are not — they signal that the classification's primary organizing principle doesn't cover the items, and the right response is either adjusting the principle or identifying a new top-level category, never adding "misc" and moving on); and that taxonomies are static (they are not — they require governance: assignment-rule documentation, periodic audits for drift, alias maintenance as terminology evolves).

Coverage

Design controlled classification systems for skills, docs, product catalogs, navigation trees, knowledge graphs, and tags. Covers hierarchy shape, facet selection, synonym control, category granularity, assignment rules, governance, and drift cleanup. Use SKOS-grade distinctions: broader/narrower for hierarchy, related for association, preferred labels for canonical terms, alternate labels for aliases.

Philosophy of the skill

A taxonomy is a retrieval contract. It should make things findable by the people or agents who browse it, not mirror the author's private mental map. The main failure mode is mixing incompatible organizing principles: by audience, by tool, by lifecycle phase, by domain, and by risk all in the same tree.

Prefer shallow, stable, mutually understandable structure. Add facets when one tree cannot express all valid access paths. Do not turn every semantic relation into a hierarchy.

Method

  1. Name the retrieval tasks: what questions must the taxonomy answer?
  2. Choose one primary organizing principle for the tree: domain, activity, artifact, lifecycle, or risk.
  3. Move secondary dimensions into facets or tags.
  4. Apply the substitution test to every parent-child pair: every child must be a kind of the parent.
  5. Define assignment rules for ambiguous cases.
  6. Add canonical labels and aliases; never let synonyms become sibling categories.
  7. Test with real items and real prompts; count "misc", duplicates, and uncertain assignments.

Verification

  • Every child category passes the IS-A substitution test against its parent
  • Sibling categories share the same organizing principle
  • Cross-cutting concerns are facets/tags, not duplicated branches
  • Canonical labels and aliases are explicit
  • Ambiguous assignment rules are written down
  • No category exists only because one item needed somewhere to go
  • Real items can be placed without using a catch-all bucket

Do NOT Use When

Use insteadWhen
ontology-modelingYou need formal class/property axioms, RDF/OWL semantics, or automated reasoning.
knowledge-modelingYou are still choosing between graph, frame, rule, concept-map, or hybrid representations.
semantic-relationsYou only need to type the relation between two concepts.
information-architectureYou are arranging pages, navigation, labels, and wayfinding for a user-facing experience.

Key Sources

  • Ranganathan, S. R. (1933/1962). Colon Classification and Prolegomena to Library Classification (3rd ed.). Asia Publishing House. The foundational statement of faceted classification and the PMEST formula (Personality / Matter / Energy / Space / Time); the alternative to strict hierarchical trees that all modern multi-criteria classification descends from.
  • W3C. SKOS Simple Knowledge Organization System Reference (2009). The standard data model for taxonomies and thesauri: broader/narrower/related, prefLabel/altLabel, and the minimal formalism required for transmissible classification.
  • Bowker, G. C., & Star, S. L. (1999). Sorting Things Out: Classification and Its Consequences. MIT Press. The canonical critical study of how classifications shape what becomes thinkable; the source of the "boundary infrastructure" framing and the empirical evidence that taxonomies without explicit retrieval-task analysis become abandoned bureaucratic structure.
  • Hjørland, B. (2008). "What is Knowledge Organization (KO)?" Knowledge Organization, 35(2-3), 86-101. Authoritative survey of the field; situates taxonomy design within library and information science.
  • Aristotle. Categories (c. 350 BCE). The philosophical root of hierarchical classification: genus-species definitions, the predicables, and the structure that two and a half millennia of taxonomy work has built on or against.
  • Vander Wal, T. (2005). "Folksonomy." The coinage and definition of folksonomy; the alternative to controlled vocabulary and the trade-offs that come with emergent tagging.
  • Morville, P., & Rosenfeld, L. (2006). Information Architecture for the World Wide Web (3rd ed.). O'Reilly. The practitioner reference for taxonomy work in user-facing systems; the bridge from classification to navigation.
  • Glushko, R. J. (Ed.). (2013). The Discipline of Organizing. MIT Press. Cross-disciplinary synthesis treating classification as a design activity rather than a domain reflection; explicit attention to facet design and retrieval-task analysis.
  • Schema.org. Type Hierarchy. A pragmatic large-scale web taxonomy; a real-world example of design choices, facet vs hierarchy decisions, and the costs of governance at scale.

Skill Graph context

<!-- skill-graph-context:start (generated — do not edit by hand) -->

Classification

  • Subject: knowledge-organization
  • Public: true
  • Domain: foundations/classification
  • Scope: Teaches controlled classification systems for categories, facets, browse taxonomies, SKOS broader/narrower links, assignment rules, synonym control, and duplicate-category cleanup. Excludes formal ontology axioms, representation-paradigm choice, single-edge relation typing, and UI-copy/navigation-label writing.

When to use

  • our skill categories are drifting: some are by domain, some by activity, and some by tool - how should the taxonomy be redesigned?
  • should these be tags, facets, or child categories?
  • build a clean category tree for these concepts without making every related term a parent-child relation
  • we have analytics, observability, telemetry, and monitoring as categories - which should merge and which should stay separate?

Not for

  • define OWL class restrictions and property domains for this knowledge base
  • decide whether this knowledge should be represented as a graph, frame, rules, or hybrid
  • type this single relation as meronymy, causality, synonymy, or thematic role
  • write user-facing labels for this navigation item

Related skills

  • Depends on: semantic-relations
  • Verify with: context-graph, semantic-relations
  • Related: skill-infrastructure, information-architecture, context-graph, canonical-repo-structure, conceptual-modeling

Concept

  • Mental model: |
  • Purpose: |
  • Boundary: |
  • Analogy: Taxonomy design is to a knowledge surface what a public library's call-number system is to its collection — the books haven't changed, but the system determines which books a researcher finds when looking under 'biology' versus 'medicine' versus 'public health.' A library that categorizes by acquisition date (the author's mental map) is unfindable; one that categorizes by subject with cross-references and facet headings (retrieval contract for the navigator) is searchable. Dewey Decimal is a hierarchy with facet-like subdivisions; Library of Congress is more faceted; both are taxonomies, both have explicit retrieval-task analyses behind their structure.
  • Common misconception: |

Keywords

  • taxonomy design, controlled vocabulary, browse taxonomy, category hierarchy, facets, tagging rules, broader narrower, SKOS hierarchy, classification cleanup, duplicate categories
<!-- skill-graph-context:end -->

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Keep looking

Skills are one crate of 326,629. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.