semantic-relations — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited semantic-relations (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
Semantic relations are the typed connections between concepts in a meaning structure -- the edges in a knowledge graph, concept map, taxonomy, ontology sketch, or hierarchy, each of a named kind rather than a generic association. Drawn from lexical semantics, Princeton WordNet, W3C SKOS, W3C OWL property semantics, and FrameNet-style semantic roles, this skill treats every edge as a claim about traversal, inference, substitution, or role assignment.
Replace generic related-to edges and untyped associations with named relation types that enable meaningful traversal, reasoning, retrieval, and disambiguation. Most knowledge-system failures are not failures to name nodes; they are failures to type the connections between nodes. A graph with only related-to edges cannot support reliable path reasoning. A naming audit that cannot separate synonymy from polysemy suggests the wrong fix. A skill system that cannot tell adjacency from boundary loads the wrong context.
This skill owns pre-formal relation typing: choosing whether a connection is IS-A, PART-OF, synonymy, polysemy, causal, thematic, associative, or property-constrained. It does not own word morphology or audience register (linguistics), the meaning encoded by a single identifier or signal (semantics), full domain structure discovery (conceptual-modeling), representation-paradigm choice (knowledge-modeling), formal class/property axioms and reasoning constraints (ontology-modeling), taxonomy/facet governance (taxonomy-design), database relationship implementation (entity-relationship-modeling), operational cross-system ID correspondence (relational mapping), or visual sign systems (semiotics). Semantic-relations is to a knowledge graph what road-type labels are to a transit map: motorway, slip road, roundabout, bridge, tunnel, and one-way street are each typed connections with their own traversal rules. A map that labels every road connector is nearly useless for navigation; precise relation vocabulary makes the map a tool rather than an illustration. The wrong mental model is that relation typing is academic overhead and that related-to plus context is sufficient. It is not. Adjacent misconceptions: that PART-OF and IS-A are interchangeable; that synonymy means duplicate concepts; that polysemy is the same as homonymy; that all PART-OF relations are transitive; that thematic roles are just labels; and that relation properties can be omitted until implementation. Each shortcut changes the inferences readers and tools make.
Semantic relation analysis as a typed-connection discipline. Covers four families of relations and their properties:
Application surfaces include knowledge-graph edge typing, naming disambiguation (synonymy vs polysemy vs homonymy), skill / module boundary analysis (adjacent vs boundary vs verify-with), category / hierarchy sanity checks, and relation-aware explanation of how concepts connect. Includes a six-item anti-pattern catalog (generic related_to edges, circular IS-A, conflated PART-OF and IS-A, synonym sprawl, untyped polysemy, property-free relation definitions) and a six-item verification checklist.
Every complex system depends on relation quality, not just node quality. Most knowledge-system failures are not failures to name the things; they are failures to type the connection between things. A graph with only related_to edges is nearly useless for reasoning. A naming audit that cannot separate synonymy from polysemy suggests the wrong fix. A skill system that cannot tell adjacency from boundary loads the wrong context.
The discipline is: name the relation, then test whether the name is the right kind of relation. If "A is B" fails the substitution test, it is not hypernymy. If a part-whole relation changes lifecycle semantics, it is not just loose association. If two words share one form but multiple related meanings, that is polysemy, not synonymy. Precision here compounds into every other knowledge and modeling skill — the quality of every downstream representation depends on whether the relations were typed correctly upstream.
This skill is the vocabulary layer. It does not own the formal axioms (an ontology skill), the storage shape (an ER-modeling skill), the cross-system data correspondence (a relational-mapping skill), or the broader knowledge-representation paradigm (a knowledge-modeling skill). It owns the question: what kind of relation is this?
| User need | Use | Why |
|---|---|---|
| Word form, morphology, abbreviation, audience register, or blame-free phrasing | linguistics | Linguistics owns how terms are formed and phrased; semantic-relations owns the typed connection between meanings. |
| Meaning encoded by one name, status, version, commit type, token, or signal | semantics | Semantics owns the truthfulness of a single sign; semantic-relations owns the edge between two meanings. |
| Full entity/attribute/relationship model before implementation | conceptual-modeling | Conceptual-modeling builds the model; semantic-relations supplies precise relation vocabulary inside it. |
| Representation choice: graph, frame, rules, concept map, or hybrid | knowledge-modeling | Knowledge-modeling chooses the container; semantic-relations names the edge types inside the container. |
| Formal classes, properties, domain/range, axioms, SHACL, OWL, or reasoning semantics | ontology-modeling | Ontology-modeling turns durable relations into machine-checkable commitments; semantic-relations stays pre-formal. |
| Category tree, facets, browse taxonomy, assignment rules, or SKOS governance | taxonomy-design | Taxonomy-design owns the governed classification system; semantic-relations tests individual hierarchy/association claims. |
| Foreign keys, junction tables, cardinality constraints, or persistence schema | entity-relationship-modeling | ER modeling implements data relationships; semantic-relations analyzes conceptual meaning before implementation. |
| Term | Definition | Example |
|---|---|---|
| Hypernym | The more general category | Vehicle is a hypernym of Car |
| Hyponym | The more specific category | Car is a hyponym of Vehicle |
| Co-hyponyms | Same-level members of a category | Car, Truck, Motorcycle are co-hyponyms of Vehicle |
Properties:
Rules:
| Term | Definition | Example |
|---|---|---|
| Holonym | The whole | Order is holonym of LineItem |
| Meronym | The part | LineItem is meronym of Order |
Types of part-whole:
| Type | Part can exist alone? | Example |
|---|---|---|
| Component-integral | No | Engine is component of Car |
| Member-collection | Yes | Tree is member of Forest |
| Portion-mass | No | Slice is portion of Pie |
| Stuff-object | No | Wood is stuff of Table |
| Feature-activity | No | Payment is feature of Checkout |
| Place-area | Yes | Room is place in Building |
Rules:
| Relation | Definition | Software impact |
|---|---|---|
| Synonymy | Different words, same meaning | customer, client, buyer may collapse into one canonical term |
| Near-synonymy | Similar but not identical meaning | error, failure, fault may need explicit distinctions |
| Antonymy | Opposite meaning | credit vs debit, active vs inactive |
| Complementary antonymy | Binary opposition, no middle | true / false |
| Gradable antonymy | Scale with degrees | high / low |
| Relational antonymy | Paired roles | buyer / seller, parent / child |
Rules:
inactive, disabled, and off unless the distinctions are real.| Relation | Definition | Software impact |
|---|---|---|
| Polysemy | One form, multiple related meanings | order can mean purchase, sequence, or command |
| Homonymy | One form, unrelated meanings | bank as finance vs river bank |
Rules:
| Relation | Definition | Example |
|---|---|---|
| Metonymy | One concept stands in for a closely related concept | shipped used to denote an order's current state rather than the act itself |
Rules:
| Role | Definition | Example |
|---|---|---|
| Agent | The entity that performs the action | Customer places order |
| Patient | The entity affected by the action | Order is placed by customer |
| Instrument | The means by which the action is performed | Payment processed via payment provider |
| Location | Where the action occurs | Order placed in storefront |
| Source | Where something comes from | Shipment from warehouse |
| Goal | Where something goes | Delivery to destination address |
| Cause | What triggers the action | Webhook triggers order sync |
| Result | What the action produces | Payment produces receipt |
| Temporal | When the action occurs | Order placed on 2026-03-29 |
| Beneficiary | Who benefits from the action | Refund issued for customer |
Rules:
| Property | Definition | Test |
|---|---|---|
| Symmetric | If A relates to B, then B relates to A | sibling_of |
| Asymmetric | If A relates to B, then B does NOT relate to A the same way | is_a |
| Transitive | If A → B and B → C, then A → C | ancestor_of |
| Reflexive | A relates to itself | equal_to |
| Irreflexive | A cannot relate to itself | parent_of |
Rules:
broader / narrower assertions from transitive closure relations.| Bad (vague) | Better (typed) | Why |
|---|---|---|
A -- related_to -- B | A -- is_a -- B | Preserves hierarchy meaning |
A -- linked_to -- B | A -- causes -- B | Preserves causal meaning |
A -- see_also -- B | A -- adjacent_to -- B | Makes proximity type explicit |
A -- has -- B | A -- composed_of -- B | Separates part-whole from loose ownership |
| Skill-system relation | Semantic relation analogue |
|---|---|
related (formerly adjacent) | Associative or thematic proximity |
boundary | Scope separation between neighboring categories or co-hyponyms |
verify_with | Instrumental relation: one skill is used to validate another |
When two names conflict:
| Anti-Pattern | Problem | Fix |
|---|---|---|
| Generic `related_to` edges | No semantic information; poor reasoning and poor graph traversal | Type the edge with a specific relation |
| Circular IS-A | A is-a B is-a C is-a A | Keep the hierarchy acyclic and substitution-valid |
| Conflated PART-OF and IS-A | Treating a component as a subtype | Apply the substitution test first |
| Synonym sprawl | Several labels for one concept | Canonical term + explicit aliases |
| Untyped polysemy | One term overloaded across domains | Qualify the term or split the concept |
| Property-free relation definitions | Named relation with no symmetry/transitivity reasoning | State the relation properties explicitly |
After applying this skill, verify:
| Instead, use | Why |
|---|---|
linguistics | Analyzing word morphology, polysemy at the identifier level, audience register, or blame-free phrasing. Linguistics covers word-form rules; semantic-relations covers meaning-connection types. |
conceptual-modeling | Building the full concept structure (entities, attributes, relationships, invariants). Conceptual-modeling owns structure; semantic-relations owns the relation-typing vocabulary used inside it. |
knowledge-modeling | Choosing the representation paradigm — graph vs frames vs rules vs hybrid — for a knowledge surface. Knowledge-modeling chooses the paradigm; semantic-relations chooses the relation vocabulary inside it. |
| (an ontology skill) | Building formal ontologies with class/property axioms, restrictions, and reasoning semantics. Ontology formalizes; semantic-relations supplies the relation vocabulary before formalization. |
| (an entity-relationship-modeling skill) | Designing database foreign keys, junction tables, and physical schema constraints. ER modeling implements physical relationships; semantic-relations analyzes conceptual ones. |
| (a relational-mapping skill) | Mapping entities between different systems or platforms operationally. Relational mapping is operational data correspondence, not conceptual relation typing. |
| (a taxonomy skill) | Designing hierarchy or facet structures themselves. Taxonomy owns the structural classification system; semantic-relations owns the relation meanings used within and around it. |
| (a semiotics skill) | Auditing iconography, color connotation, or interface sign systems. Semiotics handles signs in interfaces; semantic-relations handles concept-to-concept meaning relations. |
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.