semiotics — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited semiotics (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.
Semiotics is the discipline of designing and auditing the multi-channel sign systems through which an interface communicates with its users. Its primitives are signifiers (perceivable forms — icons, colors, shapes, positions, words, interaction cues) and signifieds (the concepts, states, actions, or judgments those forms point to), and its working vocabulary comes from four sources: Peirce's icon/index/symbol trichotomy (a sign resembles, causally connects to, or arbitrarily conventions its referent), Saussure's signifier/signified dyad, Barthes' denotation/connotation/myth layers, and Norman's affordance theory (real affordance, perceived affordance, signifier, anti-affordance). The skill applies these models across visual surfaces (color, shape, position, iconography) and textual/code surfaces (function names, API endpoints, error messages) under one governing rule: one signifier should point clearly to one intended signified within a given system context. Its central insight is that every interface element is already communicating whether the designer intended it to or not, so the job is to make that communication intentional and coherent rather than to leave it to aesthetic intuition. Sign drift — a gear icon that means different things on different pages, a green badge that connotes "good" while the metric worsens, a disabled button that still looks clickable — is not a cosmetic quirk; it is a sign failure that imposes inference cost on the reader and compounds into distrust of the whole surface.
Semiotic analysis as the study of sign systems in software interfaces and communication. Covers:
processData() are signifier failures even when the implementation worksThe skill operates above microcopy execution and color-token math, and below formal ontology. It owns the question "what does this sign communicate to a user?", not "what should the button say?", "what hex value is this?", or "what class hierarchy do these things belong to?".
Every interface element is already communicating, whether the designer intended it to or not. Semiotics exists to make that communication explicit and coherent. A button that looks clickable but is disabled, a green badge that signals "good" when the metric is actually worsening, or a gear icon that means different things on different pages are not visual quirks; they are sign failures that erode user trust one micro-misread at a time.
The core rule is: one signifier should point clearly to one intended signified within a given system context. The more a sign drifts, the more users (and agents) are forced to infer meaning from guesswork rather than from the system itself. Sign drift compounds — a single ambiguous icon is a small cost; ten ambiguous icons across a product is a learned distrust of the entire surface.
This skill is sign analysis, not visual craft. It tells you whether a sign communicates the right meaning. It does not tell you how to lay out the screen, what hex value to use, what class hierarchy to formalize, or what wording to put on a button. Each of those belongs to a different skill in the design / language / data cluster.
| Sign type | Relationship to meaning | UI example | Strength |
|---|---|---|---|
| Icon | Resembles what it represents | Magnifying glass = search | Intuitive but culturally variable |
| Index | Causally connected to meaning | Loading spinner = something is happening | Direct but context-dependent |
| Symbol | Arbitrary convention | Red = danger, hamburger = menu | Efficient once learned |
Rules:
| Component | Definition | Application |
|---|---|---|
| Signifier | The perceivable form | Color, shape, text, icon, animation |
| Signified | The concept or meaning | Action, state, category, judgment |
Rules:
| Layer | What it is | Example |
|---|---|---|
| Denotation | Literal reading | Up arrow = increase |
| Connotation | Associated judgment / cultural meaning | Green = positive / good |
| Myth | Systemic or ideological framing | Growth as inherently desirable |
Rules:
| Color | Common denotation | Common connotation | Risk |
|---|---|---|---|
| Red | Error, stop, danger | Bad, urgent, loss | Overuse dulls alarm meaning |
| Green | Success, active, up | Good, growth, healthy | Wrong when used for undesirable increases |
| Yellow / Amber | Warning, caution | Attention needed | Easily confused with error |
| Blue | Information, trust, link | Calm, corporate, neutral authority | Can become semantically empty if overused |
| Grey | Inactive, secondary, disabled | Neutral, quiet | May fail as an anti-affordance if too subtle |
Rules:
a11y or visual-design-foundations; semiotics evaluates only whether the sign itself is coherent.| Sign channel | Common reading |
|---|---|
| Top-left placement | Primary or first-scanned element |
| Top-right placement | Tools, account, utility actions |
| Bottom-right placement | Primary CTA in a dialog |
| Circle | Status, avatar, completion |
| Triangle / arrow | Direction, expansion, movement |
| Pill / badge | Category, state, count |
Rules:
| Principle | Rule |
|---|---|
| Consistency | Same concept = same icon across the product |
| Metaphor clarity | The metaphor should be legible without specialist training |
| Pairing | Abstract or unfamiliar icons need text pairing until learned |
| System coherence | Use one icon family unless there is a compelling reason not to |
Common breakdowns:
| Concept | Application |
|---|---|
| Real affordance | What the element can actually do |
| Perceived affordance | What the element appears to allow |
| Signifier | The cue that tells the user action is possible |
| Anti-affordance | The cue that tells the user action is not possible |
Rules:
Semiotics also applies to textual and code-facing signs.
| Sign surface | Semiotic question |
|---|---|
| Function name | Does the signifier actually tell me what the behavior is? |
| Variable name | Does the label point clearly to the value's meaning? |
| API endpoint | Does the route name communicate the resource / action correctly? |
| Error message | Does it communicate both what happened and how to respond? |
Rule: a vague name like processData() is a signifier failure even when the implementation works. The reader has to open the function to learn its meaning — which is exactly the inference cost a good sign eliminates.
This overlaps with semantics (which owns identifier-level meaning encoding); semiotics adds the sign-system lens — is the same concept signed consistently across both code names and visual interface elements?
Use this checklist when reviewing a surface:
After applying this skill, verify:
| Instead, use | Why |
|---|---|
microcopy | Drafting the actual button labels, empty states, tooltips, or toasts. Microcopy owns the wording; semiotics owns the sign system the wording lives inside. |
semantics | Deciding the meaning encoding of a single identifier, design token, HTTP status code, or commit type. Semantics owns identifier-level meaning; semiotics owns the multi-channel sign system. |
semantic-relations | Typing the connection between two concepts (IS-A, PART-OF, thematic, causal). Semantic-relations owns concept-to-concept relations; semiotics owns sign-to-meaning mappings. |
linguistics | Word morphology, compound-word ordering, abbreviation policy. Linguistics owns word-form rules; semiotics owns broader sign systems including visual ones. |
a11y | Auditing aria-label correctness, focus management, screen-reader semantics. A11y owns accessibility contracts; semiotics may inform them but does not own them. |
visual-design-foundations | Palette, typography, spacing, hierarchy, craft quality, and motion feel. Visual-design-foundations owns visual craft; semiotics asks what the visual element signifies. |
| (an ontology skill) | Formal class hierarchies, existence axioms, reasoning constraints. Ontology owns formal classification; semiotics owns sign meaning in interfaces. |
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.