Index of every page on this site: llms.txt
All skills
raphaelsalaja avatar

/iconset

@b2e4283
Run it yourself

Builds or redraws a whole icon library, from the user's references and an audit of the old set through a style picked from drawn tiles, a written voice and shared parts to one build command.

Use this Skill: https://skilld.dev/gh/raphaelsalaja/skills/iconset

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

formats.md

≈2.3k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Formats

The files an icon library keeps beside its drawings. The drawings read the variables, and the build command reads every file after them, so the code and the catalogue never drift.

Everything that outlives the review is committed in the icon source folder, such as icons/. The review lives in the ignored .iconset/. The scripts, parts/ and helpers.mjs exist only where the agent draws.

icons/
  style.md  style.json  concepts.md  migration.json  icon-spec.md
  helpers.mjs
  parts/                one script per registered part
  src/                  one script per icon
  svg/                  the exported tree, manifest.json and REPORT.md
.iconset/
  index.html  review.js  render.mjs
  fonts/                the product's font files, when not installed
  directions/<name>/    each direction's scripts and its own style.json

Style

style.md records how the direction was picked. The voice and the stroke step start from it, and a later redraw reads why.

## References
Loved: the linked set - 1.5 stroke, round ends, 2 radius, closed shapes. "Calm, nothing shouts"
Loved: the user's notes app - filled when selected, duotone back layer at 0.3
Disliked: the old set - butt ends and sharp corners. "Too harsh next to the rounded buttons"
Change first: tag, sparkle, settings

## Signals
Type: humanist sans, l stem 1.26 at 14px, contrast 1.1:1, open apertures, round terminals, x-height 0.53
Labels: 14px regular
Radius: 10px controls, pill buttons
Logo: circles and one free curve
Platform: web and iOS, bottom navigation on phones
Theme: light first
Tiers: UI icons, plus pictograms on empty states

## Traits
Calm, but not sleepy
Friendly, but not childish

## Offered
Round, Soft, Keep the old set's style

## Picked
Round. Soft read thin beside the labels on a phone.

## Fill
Line, filled when selected, duotone back layer at 0.3

## Voice
Must: closed shapes. Broken: a folder with an open top. Fixed: the folder closed along its tab.
Must: one diagonal angle, 45°. Broken: a 40° arrow. Fixed: the arrow at 45°.
Should: lines run on to the keyline. Broken: a phone stopping short of the keyline. Fixed: the phone on the tall keyline. Bent in: bolt, which reads better at its own height.
Standard: no icon takes more attention than the label beside it.

## Stroke
16: 1.25, beside the 14px regular labels (l stem 1.26). 1.5 outweighed them.
24: 1.75, beside the 20px medium title (l stem 2.26). The stroke the user set; 2 drew the eye first.

## Changes
First batch: "a bit harsh". Round ends picked over a larger radius and a lighter stroke.

Variables

style.json holds the picked values every drawing reads. Change a value, regenerate the set and reopen the review page.

{
  "sizes": {
    "16": { "stroke": 1.25, "radius": 2, "cut": 1.25 },
    "24": { "stroke": 1.75, "radius": 3, "cut": 2 }
  },
  "caps": "round",
  "joins": "round",
  "fill": "line, filled when selected",
  "duotone": { "back": "opacity", "opacity": 0.3 }
}

radius is the largest a corner takes, as Radius by part says. cut is the gap where a badge or slash clips a shape, and it is never narrower than that size's stroke. duotone is absent when the set has none, and back is opacity or colour.

Icon scripts

Where the agent draws, each icon is a script that returns its parts from shared helpers. The caller passes the size, the values and the helpers, so one script draws every size, direction and one-change variant. A named override sits beside the part it bends, as the star's corners show.

// star.mjs
export default ({ poly, starPoints }) =>
  poly(starPoints(), {
    closed: true,
    // 36° points: a quarter of 3.4, halved for the angle.
    corners: { points: 0.425 },
  });

helpers.mjs scales 24-grid coordinates to each size, snaps anchors to the grid step and applies the radius table, so a script names only its shape.

Snap what the helpers compute too: where a rounded corner's arc starts and ends, each corner radius, each curve's end point and each dot's radius. Unsnapped, a 45° corner lands at 10.563 and the seed fails the grid lint. Curve handles stay free.

A named override is in 24-grid units and scales with the rest. A script may branch on size where a smaller drawing needs its own coordinates, such as loops kept a stroke apart at 16.

draw(script, size, style, { morph }) writes the morph form for icons marked Swaps. It turns lines, arcs, circles and Z into an M and explicit C segments, then pads to the pair's larger path and segment counts.

.iconset/render.mjs draws every script with each direction's values, or with style.json once one is picked, and writes review.js. Run it after every change, because a page opened from disk cannot import modules or fetch JSON.

import { readFileSync } from "node:fs";
import { draw } from "../icons/helpers.mjs";
import folder from "./directions/round/folder.mjs";

const round = JSON.parse(readFileSync(new URL("directions/round/style.json", import.meta.url)));
const svg = { 16: draw(folder, 16, round), 24: draw(folder, 24, round) };

The build runs the same scripts, so the scripts and the SVG tree never disagree.

Parts

Each registered part is a script in parts/. It draws at a fixed size and position and exports any anchor a badge needs. An icon script imports it, so a change to the part redraws every icon that uses it.

// parts/folder.mjs
export const centre = [12, 13.5];
export default ({ poly }) => poly([[3, 5], [9, 5], [11.5, 7.5], [21, 7.5], [21, 19.5], [3, 19.5]], { closed: true });

// src/folder-plus.mjs
import folder, { centre } from "../parts/folder.mjs";
import plus from "../parts/plus.mjs";
export default (k) => [folder(k), plus(k, centre)];

render.mjs reads the imports to write the review page's Parts section, so each part's overview lists exactly the icons built from it.

Concepts

Each concept appears once and each icon answers one concept. The tags carry the synonyms, so they also feed the catalogue's search.

| Concept | Icon | Tags | Marks |
| --- | --- | --- | --- |
| Agent | `sparkle` | ai, assistant, model | Contested: picked from 14 versions |
| Search | `magnifying-glass` | search, find, lookup | |
| Play | `play` | start, run, resume | Swaps with `pause` |
| Expand | `chevron-down` | expand, open, disclosure | Swaps with `chevron-right`, Spins |
| Billing | `banknote` | billing, payment, invoice | Local: no currency sign |
| Parallel run | `lanes` | parallel, concurrent, fan out | Contested, new: 4 of 5 in testing |

Marks records what the steps decided. Contested names the picture it came from, Swaps names its partner and Local names the neutral form or the locales. A new metaphor adds its test result. Spins marks a Swaps pair that is one drawing turned, which rotates and skips the morph form.

Keep the table this shape, one row per concept, because the review page, the export and the catalogue all parse it.

Migration

migration.json holds one entry per old icon. To Do is unmapped. Coupled names the replacement and keeps the old codepoint where the set has codepoints. Removed records the reference count, which is 0 before the swap.

{
  "arrow-up": { "state": "Coupled", "to": "ArrowUp", "codepoint": "U+E001" },
  "dollar": { "state": "Coupled", "to": "Banknote", "references": 1 },
  "debug-alt": { "state": "Removed", "references": 0 },
  "git-fetch": { "state": "To Do" }
}

A set with no codepoints, such as a map of SVG strings, records each coupled icon's references instead.

SVG tree

One folder per icon, its concepts.md name in the casing of the project's icon API, such as arrow-right as ArrowRight. Each drawn style and size gets one file. A combination never drawn has no file, so the generated type lists only the sizes that exist.

Where the agent draws, the export renders each script at every size in style.json, and the Swaps icons that do not spin in the morph form. It reads each concept and its tags from concepts.md. Where a designer draws, the design tool's export plugin writes the same tree.

svg/
  ArrowRight/
    outline-16.svg
    outline-24.svg
    fill-16.svg
  manifest.json
  REPORT.md

manifest.json names every icon with its concept, tags, codepoint and variants:

{
  "ArrowRight": {
    "concept": "Next",
    "tags": ["next", "forward", "continue"],
    "codepoint": "U+E014",
    "variants": [
      { "style": "outline", "size": 16, "file": "ArrowRight/outline-16.svg" },
      { "style": "outline", "size": 24, "file": "ArrowRight/outline-24.svg" },
      { "style": "fill", "size": 16, "file": "ArrowRight/fill-16.svg" }
    ]
  }
}

REPORT.md lists one miss per line with the source node or script to open. It also lists a migration entry still To Do or coupled to an icon that is not drawn. The build stops while it has any line:

ArrowRight fill-24 - empty variant, node 412:1180
FileLock outline-24 - artwork 0.5 past the frame with no overflow, node 520:44
Folder outline-16 - duplicate of Directory outline-16, node 88:902

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts1d3 checks · Risk SAFE
  • Gen Agent Trust Hub1d

    This skill provides a structured methodology for auditing, designing, and building icon libraries, including automated component generation from SVG assets. No security threats or malicious patterns were identified.

  • Socket1d

    No alerts

  • Snyk1d

    Risk: LOW · No issues

Signed by skilld at b2e4283. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 12 hours ago.

Activeupdated yesterday
disable-model-invocation
true

README badge

README badge for raphaelsalaja/skills/iconset