Iconography
Choose and specify icons — which set, which token, what size, what colour, RTL placement — and say whether the licence permits it in a paid client deliverable. Ships no icon files: the catalogue is commodity (Iconify maintains 334,616 across 236 sets), so what ships is the contract layer the 19 consuming skills describe and nobody had written down. 43 semantic slots harvested from those skills and resolve-verified live, 236 sets licence-classed against SPDX, and four scripts that print numbers. GUIDANCE-ONLY: the agent's own LLM composes the work from the bundled references, recipes, registry and learnings.
Nineteen of our own skills describe icon slots roughly 875 times, and not one SVG glyph existed anywhere in the fleet. The obvious fix is a curated icon set. That is the wrong fix, and building it would have wasted the work: the catalogue is commodity, and Iconify already maintains 334,616 icons across 236 sets with machine-readable licences. What does not exist is the contract. Icons must bind to currentColor or they cannot inherit a brand. A 16 pixel glyph is fine; a 16 pixel tap target fails WCAG 2.5.8. Icon strokes need 3:1, not the 4.5:1 people quote from the text rule. And in Hebrew or Arabic the icon moves to the logical right in source order — a rule no icon library documents, that turns a trailing arrow into an arrow pointing away from the reading direction. So this ships 43 semantic slots harvested from the consuming skills rather than invented, each carrying its token per set with SPDX and a retrieval date, plus four scripts that print numbers. One of them caught a real defect in this package's own registry on its first run: Lucide had renamed an icon twice, and a dead token renders nothing at all — no error, no warning.
Features5
Gates currentColor, target size, 3:1 contrast, radius and RTL against WCAG 2.2.
Classes 236 sets GREEN/AMBER/RED for paid client work; rejects in writing.
Checks every token live; upstream renames kill icons with no build error.
Mirrors directional glyphs in source order for HE and AR; no library documents this.
CC0 licences the drawing, never the mark; every logo asserts why it may appear.
Videos1 video
DemoIconography · Demo video
Demo · SpiderMediaArticles about Iconography2 articles
An icon set is not an icon system. Your agent now knows.
opvs.ai23 Aug 2026An icon set is not an icon system. Your agent now knows.
236 icon sets, one question: may you ship this to a client? The catalogue is a solved commodity. The contract around it was written down nowhere, so I wrote it down.
Videos1 video
DemoIconography · Demo video
Demo · SpiderMediaArticles about Iconography2 articles
Showing all 2
SKILL.mdthe file your agent reads
SKILL.md loads when you open this tab.
What's new3 releases · newest first · from the package's CHANGELOG
v0.1.22026-11-10Latest
Marketplace listing update: added the launch explainer film (`media.demo_video_url`). No code, schema, copy or guidance changes; hero and screenshots unchanged from 0.1.1.
v0.1.12026-08-23
Marketplace card asset kit. Adds the top-level `media:` block: one hero and four panels, rendered dark-board chalk and reused verbatim as the blog cover, the blog inline figures and the listing-page hero. No behaviour, registry or script changes.
v0.1.02026-08-23
First release. Guidance-only.
### Added
- **43 semantic icon slots**, harvested from 19 shipped consumer skills rather than invented, each carrying its token per set (`lucide` · `tabler` · `ph`) with SPDX, licence URL and `retrieved_on`. All 106 tokens resolve-verified live against the Iconify API.
- **Four references** — licence decision (end-use framing, GREEN/AMBER/RED), icon contracts (WCAG 1.4.11 / 2.5.8 / 2.5.5 + `currentColor` + radius + RTL), style matching (per-design-system selection, proprietary-font substitution), brand marks and trademarks (permitted-use vocabulary).
- **Three recipes** — pick an icon for a section · standardise a marketplace card · source a brand mark.
- **Four enforcement scripts** — `verify-licence-clean` · `verify-token-resolves` · `verify-icon-contract` · `audit-manifest-icons`. Each prints PASS/FAIL with counts.
- **Three learnings** — upstream renames kill tokens silently · an aggregate across vendors inverted a finding · "icon" meant three different things across the consumers.
### Notes
- Ships **no icon files**. The catalogue is commodity; the contract layer is the product.
- The RTL source-order rule is not documented by any icon library surveyed. Di-Atomic ships HE and AR.
- Does **not** fix `@di-atomic/infographic`'s label→icon binding defect — that is a render-time bug.
- `media: {}` is empty by design; `/skill-propagate` renders and patch-bumps.Showing all 3
