agentsclimarketplace

Semiotics

Skill jacob-balslev/skills/skills/design/semiotics

Public Agent Skills library exported from skill-graph. Install: npx skills add jacob-balslev/skills

Install
npx -y skills add jacob-balslev/skills --skill semiotics

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

One thing to look at

  • 0 stars0 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 author says it does

Copied from the file, not written here

Use when designing or auditing icon systems, colors/badges/shapes, visual metaphors, interface signs, or naming-plus-visual surfaces that users misread. Covers semiotic reasoning across icon/index/symbol, signifier/signified, denotation/connotation/myth, color/shape/position/iconography, affordances, code/API signifiers, and semiotic-coherence audits. Do NOT use for actual UI wording (use `microcopy`), palette/typography craft (use `visual-design-foundations`), accessibility or contrast compliance (use `a11y`), formal class hierarchies, or word morphology rules.

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

27.5 KB, as published. Nobody here has run it

Semiotics

Concept of the skill

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.

Coverage

Semiotic analysis as the study of sign systems in software interfaces and communication. Covers:

  • Foundational models — Peirce's icon / index / symbol trichotomy; Saussure's signifier / signified dyad; Barthes' denotation / connotation / myth layers
  • Visual semiotics for interfaces — color as sign (denotation + connotation, with the never-color-alone rule), shape and position as sign channels (top-left, top-right, bottom-right, circle, triangle, pill)
  • Iconography as a sign system — consistency, metaphor clarity, pairing rules, system coherence; common breakdowns (icon polysemy, opacity, cultural collision, obsolete metaphor)
  • Affordance theory — real affordance, perceived affordance, signifier, anti-affordance; the rule that disabled states need a strong anti-affordance
  • Code and API semiotics — naming, variable, endpoint, and error-message signs; the rule that vague names like processData() are signifier failures even when the implementation works
  • Semiotic-coherence audit — the checklist for reviewing a surface across color, icon, affordance, and cross-surface consistency

The 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?".

Philosophy of the skill

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.

When to Use

  • Designing or auditing icon systems
  • Checking whether a color, badge, or shape communicates the wrong judgment
  • Explaining why users misread a button, state, or symbol
  • Choosing or critiquing visual metaphors for abstract concepts
  • Auditing naming and interface signs together when a surface feels semantically off

1. Foundations — How Signs Work

Peirce's Trichotomy

Sign typeRelationship to meaningUI exampleStrength
IconResembles what it representsMagnifying glass = searchIntuitive but culturally variable
IndexCausally connected to meaningLoading spinner = something is happeningDirect but context-dependent
SymbolArbitrary conventionRed = danger, hamburger = menuEfficient once learned

Rules:

  • Prefer icons for first-use discoverability.
  • Prefer symbols for expert fluency when the convention is already learned.
  • Use indexes when the system needs to signal that a process or state is actively occurring.

Saussure's Dyad

ComponentDefinitionApplication
SignifierThe perceivable formColor, shape, text, icon, animation
SignifiedThe concept or meaningAction, state, category, judgment

Rules:

  • The same signifier should not point to multiple signifieds within one product surface unless that ambiguity is deliberate and documented.
  • Changing the signifier can break learned meaning even if the redesign seems visually improved.

Barthes' Three Layers

LayerWhat it isExample
DenotationLiteral readingUp arrow = increase
ConnotationAssociated judgment / cultural meaningGreen = positive / good
MythSystemic or ideological framingGrowth as inherently desirable

Rules:

  • Separate direction from judgment in financial UI. An increase is not always good.
  • A sign can be denotationally correct while still semantically wrong because the connotation misleads.

2. Visual Semiotics for Interfaces

Color as Sign

ColorCommon denotationCommon connotationRisk
RedError, stop, dangerBad, urgent, lossOveruse dulls alarm meaning
GreenSuccess, active, upGood, growth, healthyWrong when used for undesirable increases
Yellow / AmberWarning, cautionAttention neededEasily confused with error
BlueInformation, trust, linkCalm, corporate, neutral authorityCan become semantically empty if overused
GreyInactive, secondary, disabledNeutral, quietMay fail as an anti-affordance if too subtle

Rules:

  • Color should not be the only sign channel for important meaning.
  • Audit color decisions at both denotation and connotation levels.
  • Live token values, contrast compliance, and visual craft belong to a11y or visual-design-foundations; semiotics evaluates only whether the sign itself is coherent.

Shape and Position as Sign

Sign channelCommon reading
Top-left placementPrimary or first-scanned element
Top-right placementTools, account, utility actions
Bottom-right placementPrimary CTA in a dialog
CircleStatus, avatar, completion
Triangle / arrowDirection, expansion, movement
Pill / badgeCategory, state, count

Rules:

  • Position and shape carry meaning even without text; treat them as part of the sign system.
  • If a layout or component breaks a strong convention, ensure the surrounding cues are strong enough to retrain the interpretation.

3. Iconography as a Sign System

PrincipleRule
ConsistencySame concept = same icon across the product
Metaphor clarityThe metaphor should be legible without specialist training
PairingAbstract or unfamiliar icons need text pairing until learned
System coherenceUse one icon family unless there is a compelling reason not to

Common breakdowns:

  • Icon polysemy — one icon means several things
  • Opacity — abstract mark with no clear signified
  • Cultural collision — metaphor fails outside one audience's assumptions
  • Obsolete metaphor — the convention is still learned by some but dead to others (e.g., the floppy-disk save icon)

4. Affordance Theory

ConceptApplication
Real affordanceWhat the element can actually do
Perceived affordanceWhat the element appears to allow
SignifierThe cue that tells the user action is possible
Anti-affordanceThe cue that tells the user action is not possible

Rules:

  • If an element looks interactive, it should be interactive.
  • Disabled states need a strong anti-affordance, not just a mild color change.
  • Semiotic failures most often appear when the signifier and the true affordance disagree.

5. Code and API Semiotics

Semiotics also applies to textual and code-facing signs.

Sign surfaceSemiotic question
Function nameDoes the signifier actually tell me what the behavior is?
Variable nameDoes the label point clearly to the value's meaning?
API endpointDoes the route name communicate the resource / action correctly?
Error messageDoes 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?


6. Semiotic-Coherence Audit

Use this checklist when reviewing a surface:

  • Does each color carry one stable meaning across the product?
  • Does each icon represent one intended concept?
  • Do interactive elements look interactive?
  • Do disabled states look unavailable rather than merely quiet?
  • Are abstract concepts paired with enough textual support?
  • Is the same concept being signed consistently across UI and code-facing surfaces?

Verification

After applying this skill, verify:

  • No signifier points to multiple unintended signifieds within the same system context
  • Important interface meanings are not encoded through color alone
  • Interactive and non-interactive states have distinct affordance signals
  • Icon metaphors are coherent, learnable, and consistent across surfaces
  • Direction (denotation) and judgment (connotation) are separated in financial / metric UI
  • Code-facing signs (function, variable, endpoint names) are not vague signifier failures

Do NOT Use When

Instead, useWhy
microcopyDrafting the actual button labels, empty states, tooltips, or toasts. Microcopy owns the wording; semiotics owns the sign system the wording lives inside.
semanticsDeciding 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-relationsTyping the connection between two concepts (IS-A, PART-OF, thematic, causal). Semantic-relations owns concept-to-concept relations; semiotics owns sign-to-meaning mappings.
linguisticsWord morphology, compound-word ordering, abbreviation policy. Linguistics owns word-form rules; semiotics owns broader sign systems including visual ones.
a11yAuditing aria-label correctness, focus management, screen-reader semantics. A11y owns accessibility contracts; semiotics may inform them but does not own them.
visual-design-foundationsPalette, 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.

Key Sources

  • Peirce, C. S. (1931-1958). Collected Papers of Charles Sanders Peirce (8 vols.). Harvard University Press. The original statement of the icon / index / symbol trichotomy; the foundational typology of sign-to-referent relations that all later interface-semiotics work builds on.
  • Saussure, F. de (1916). Cours de linguistique générale / Course in General Linguistics. Payot. The signifier/signified dyad and the principle that meaning is constituted by systems of contrast — the structural foundation for sign-system analysis.
  • Barthes, R. (1957). Mythologies. Éditions du Seuil. The three-layer denotation / connotation / myth analysis; the canonical demonstration that signs carry cultural and ideological meaning beyond literal reading.
  • Eco, U. (1976). A Theory of Semiotics. Indiana University Press. The systematic treatment of semiotics as a discipline; cultural codes, sign-production, and the constructed-meaning principle.
  • Norman, D. A. (2013). The Design of Everyday Things (Revised and Expanded Edition). Basic Books. The foundational text on affordances and signifiers for interface design; the discipline of matching visual cues to actual interaction possibilities.
  • Gibson, J. J. (1979). The Ecological Approach to Visual Perception. Houghton Mifflin. The original psychological account of affordances — what the environment offers to a perceiver — that Norman adapted to design.
  • Nielsen Norman Group. "Icon Usability". Empirical UX research on icon polysemy, opacity, and the icon-plus-text pairing rule; the practitioner reference for icon-system design.
  • W3C. Web Content Accessibility Guidelines (WCAG) 2.2 — Use of Color (Success Criterion 1.4.1). The international standard expression of the never-color-alone principle.
  • Frutiger, A. (1989). Signs and Symbols: Their Design and Meaning. Watson-Guptill. The reference work on visual sign design from typography to pictograms; foundational for icon-system vocabulary work.
  • Krug, S. (2014). Don't Make Me Think, Revisited. New Riders. The practitioner statement of the cognitive-cost principle in interface signs; the empirical observation that users do not read signs analytically — they pattern-match, and the sign system must support that.

Keep looking

Skills are one crate of 328,083. 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.