Skip to content

anbeime/skill / skills/hairline/hairline

hairline

Flagged

一句话生成跟随鼠标的交互式等轴测线框图(单文件、零依赖、双击即开),或把已有 SVG/Logo 重建为可交互线框。

FileKindSize
.github/FUNDING.ymlconfig20 B
.github/workflows/ci.ymlconfig1.2 KB
.github/workflows/consumers.ymlconfig954 B
.github/workflows/publish.ymlconfig3.0 KB
.gitignoreother351 B
.npmrcother55 B
CHANGELOG.mdmarkdown7.6 KB
CONTRIBUTING.mdmarkdown4.5 KB
LICENSEother1.0 KB
README.mdmarkdown11.5 KB
SKILL.mdskill md1.2 KB
apps/site/.gitignoreother82 B
apps/site/.vitest/json/output.jsonconfig22.3 KB
apps/site/app/docs/page.tsxother2.9 KB
apps/site/app/docs/sections.tsxother8.1 KB
apps/site/app/figures/page.tsxother2.4 KB
apps/site/app/globals.cssother43.7 KB
apps/site/app/inspo/page.tsxother14.0 KB
apps/site/app/layout.tsxother978 B
apps/site/app/llms.txt/route.tsscript228 B
apps/site/app/og/page.tsxother1.5 KB
apps/site/app/page.tsxother1.7 KB
apps/site/app/robots.tsscript382 B
apps/site/app/sitemap.tsscript382 B
apps/site/app/skills/page.tsxother6.2 KB
apps/site/components/anchor.tsxother1.3 KB
apps/site/components/assembly.tsxother10.2 KB
apps/site/components/catalogue.tsxother18.6 KB
apps/site/components/chrome.tsxother2.3 KB
apps/site/components/code-block.tsxother895 B
apps/site/components/command.tsxother1.6 KB
apps/site/components/copy.tsxother2.6 KB
apps/site/components/example-frame.tsxother3.1 KB
apps/site/components/install.tsxother1.7 KB
apps/site/components/made-frame.tsxother2.0 KB
apps/site/components/rail.tsxother11.0 KB
apps/site/components/skill-link.tsxother861 B
apps/site/components/tabs.tsxother4.1 KB
apps/site/next.config.mjsscript493 B
apps/site/package.jsonmanifest927 B
apps/site/playwright.config.tsscript485 B
apps/site/postcss.config.mjsscript60 B
apps/site/public/icon.svgother262 B
apps/site/public/inspo/craft.webpbinary61.9 KB
apps/site/public/inspo/dissection.webpbinary177.4 KB
apps/site/public/inspo/figures.webpbinary56.9 KB
apps/site/public/inspo/linear.webpbinary15.6 KB
apps/site/public/inspo/tune.webpbinary58.5 KB
apps/site/public/og.pngbinary94.3 KB
apps/site/public/skill/hairline-clearance.htmlother39.5 KB
apps/site/public/skill/hairline-cursor-tab.htmlother43.4 KB
apps/site/public/skill/hairline-deploy-liftoff.htmlother43.3 KB
apps/site/public/skill/hairline-firecrawl-reader.htmlother46.6 KB
apps/site/public/skill/hairline-funnel.htmlother40.4 KB
apps/site/public/skill/hairline-linear-cycle.htmlother43.5 KB
apps/site/public/skill/hairline-mastra.htmlother44.6 KB
apps/site/public/skill/hairline-notion.htmlother41.5 KB
apps/site/public/skill/hairline-resend-belt.htmlother46.5 KB
apps/site/public/skill/hairline-sidings.htmlother43.1 KB
apps/site/public/skill/hairline-storm.htmlother42.6 KB
apps/site/public/skill/hairline-vercel.htmlother40.6 KB
apps/site/test/catalogue.test.tsscript2.7 KB
apps/site/test/docs.test.tsscript8.9 KB
apps/site/test/figures.spec.tsscript15.0 KB
apps/site/test/share.test.tsscript652 B
apps/site/test/site.spec.tsscript44.8 KB
apps/site/test/skill.spec.tsscript17.8 KB
apps/site/test/skill.test.tsscript5.4 KB
apps/site/tsconfig.jsonconfig444 B
apps/site/turbo.jsonconfig364 B
apps/site/vercel.jsonconfig214 B
apps/site/vitest.config.tsscript265 B
assets/hero.gifbinary3.7 MB
fixtures/next-app/.gitignoreother123 B
fixtures/next-app/app/layout.tsxother281 B
fixtures/next-app/app/page.tsxother587 B
fixtures/next-app/app/registry/page.tsxother714 B
fixtures/next-app/app/vanilla.tsxother353 B
fixtures/next-app/next.config.mjsscript104 B
fixtures/next-app/package.jsonmanifest364 B
fixtures/next-app/tsconfig.jsonconfig590 B
fixtures/vite-vanilla/.gitignoreother38 B
fixtures/vite-vanilla/index.htmlother1.3 KB
fixtures/vite-vanilla/package.jsonmanifest245 B
fixtures/vite-vanilla/src/main.tsscript1.3 KB
fixtures/vite-vanilla/tsconfig.jsonconfig248 B
package.jsonmanifest895 B
packages/hairline/package.jsonmanifest2.4 KB
packages/hairline/playwright.config.tsscript637 B
packages/hairline/src/core/iso.tsscript9.1 KB
packages/hairline/src/core/motion.tsscript3.8 KB
packages/hairline/src/core/stage.tsscript15.0 KB
packages/hairline/src/core/styles.tsscript4.1 KB
packages/hairline/src/figures/basket.tsscript9.5 KB
packages/hairline/src/figures/branches.tsscript7.7 KB
packages/hairline/src/figures/cabinet.tsscript7.8 KB
packages/hairline/src/figures/dish.tsscript9.7 KB
packages/hairline/src/figures/drawer.tsscript7.5 KB
packages/hairline/src/figures/elevator.tsscript7.6 KB
packages/hairline/src/figures/exploded.tsscript5.2 KB
packages/hairline/src/figures/format.tsscript6.2 KB
packages/hairline/src/figures/hub.tsscript8.6 KB
packages/hairline/src/figures/keyboard.tsscript6.3 KB
packages/hairline/src/figures/laptop.tsscript7.3 KB
packages/hairline/src/figures/lockers.tsscript7.6 KB
packages/hairline/src/figures/loupe.tsscript6.1 KB
packages/hairline/src/figures/padlock.tsscript7.7 KB
packages/hairline/src/figures/patch.tsscript10.1 KB
packages/hairline/src/figures/phone.tsscript9.6 KB
packages/hairline/src/figures/phosphor.tsscript5.6 KB
packages/hairline/src/figures/plot.tsscript5.4 KB
packages/hairline/src/figures/plug.tsscript9.7 KB
packages/hairline/src/figures/query.tsscript8.8 KB
packages/hairline/src/figures/rail.tsscript4.9 KB
packages/hairline/src/figures/rebuild.tsscript10.3 KB
packages/hairline/src/figures/relay.tsscript8.0 KB
packages/hairline/src/figures/riffle-geometry.tsscript4.2 KB
packages/hairline/src/figures/riffle.tsscript5.2 KB
packages/hairline/src/figures/router.tsscript6.4 KB
packages/hairline/src/figures/settle.tsscript8.6 KB
packages/hairline/src/figures/sieve.tsscript5.9 KB
packages/hairline/src/figures/slow.tsscript7.2 KB
packages/hairline/src/figures/stack.tsscript5.5 KB
packages/hairline/src/figures/terminal.tsscript8.1 KB
packages/hairline/src/figures/terrain.tsscript4.4 KB
packages/hairline/src/figures/turntable-geometry.tsscript3.9 KB
packages/hairline/src/figures/turntable.tsscript6.5 KB
packages/hairline/src/figures/vault.tsscript9.8 KB
packages/hairline/src/index.tsscript17.9 KB
packages/hairline/src/intensity.tsscript3.2 KB
packages/hairline/src/mount.tsscript6.5 KB
packages/hairline/src/react.tsxother9.5 KB
packages/hairline/src/slab.tsscript3.1 KB
packages/hairline/test/browser/entry.tsscript1.4 KB
packages/hairline/test/browser/figures.spec.tsscript6.3 KB
packages/hairline/test/browser/harness.htmlother321 B
packages/hairline/test/browser/look.spec.tsscript9.5 KB
packages/hairline/test/browser/parity.spec.tsscript2.4 KB
packages/hairline/test/browser/read.spec.tsscript8.9 KB
packages/hairline/test/browser/serve.mjsscript1.7 KB
packages/hairline/test/browser/skill.spec.tsscript12.3 KB
packages/hairline/test/browser/theme.spec.tsscript3.9 KB
packages/hairline/test/dom.tsscript3.0 KB
packages/hairline/test/geometry.test.tsscript2.8 KB
packages/hairline/test/intensity.test.tsscript2.1 KB
packages/hairline/test/mount.test.tsscript33.1 KB
packages/hairline/test/parity/capture.mjsscript3.6 KB
packages/hairline/test/parity/clock.jsscript3.8 KB
packages/hairline/test/parity/driver.mjsscript1.9 KB
packages/hairline/test/parity/golden/exploded.jsonconfig24.7 KB
packages/hairline/test/parity/golden/phosphor.jsonconfig28.5 KB
packages/hairline/test/parity/golden/riffle.jsonconfig137.5 KB
packages/hairline/test/parity/golden/slow.jsonconfig41.4 KB
packages/hairline/test/parity/golden/terrain.jsonconfig216.7 KB
packages/hairline/test/parity/golden/turntable.jsonconfig32.3 KB
packages/hairline/test/parity/scripts.mjsscript2.8 KB
packages/hairline/test/react.test.tsxother7.5 KB
packages/hairline/test/skill/adopt.test.tsscript1.4 KB
packages/hairline/test/skill/build.test.tsscript3.3 KB
packages/hairline/test/skill/fixtures/broken.txtmarkdown19 B
packages/hairline/test/skill/fixtures/compound.svgother148 B
packages/hairline/test/skill/fixtures/illustrator.svgother334 B
packages/hairline/test/skill/fixtures/light.svgother123 B
packages/hairline/test/skill/fixtures/mark.svgother226 B
packages/hairline/test/skill/fixtures/mixed.svgother530 B
packages/hairline/test/skill/fixtures/moved.svgother182 B
packages/hairline/test/skill/fixtures/nested.svgother274 B
packages/hairline/test/skill/fixtures/rocket.svgother577 B
packages/hairline/test/skill/fixtures/scripted.svgother199 B
packages/hairline/test/skill/kernel.test.tsscript1.8 KB
packages/hairline/test/skill/look.test.tsscript2.2 KB
packages/hairline/test/skill/read.test.tsscript9.5 KB
packages/hairline/test/skill/shape.test.tsscript8.6 KB
packages/hairline/test/skill/validate.test.tsscript10.1 KB
packages/hairline/test/ssr.test.tsxother1.1 KB
packages/hairline/test/stage.test.tsscript11.6 KB
packages/hairline/test/types.test-d.tsxother4.9 KB
packages/hairline/tsconfig.jsonconfig212 B
packages/hairline/tsup.config.tsscript844 B
packages/hairline/vitest.config.tsscript163 B
pnpm-lock.yamlmanifest129.1 KB
pnpm-workspace.yamlconfig142 B
registry/build.mjsscript1.8 KB
registry/src/hairline.tsxother4.7 KB
registry/validate.mjsscript2.2 KB
scripts/base-url.mjsscript1.4 KB
scripts/changelog.mjsscript1.3 KB
scripts/consumers.mjsscript7.4 KB
scripts/kernel.mjsscript8.8 KB
scripts/og.mjsscript1.7 KB
scripts/release.mjsscript8.0 KB
tsconfig.base.jsonconfig442 B
turbo.jsonconfig620 B

packages/hairline/test/skill/read.test.ts

View on GitHub
import { readFileSync } from "node:fs";
import { fileURLToPath } from "node:url";
import { expect, it } from "vitest";
import { card, light, nameFor, page, relate, scan } from "../../../../skills/hairline-create/read.mjs";

const FIX = fileURLToPath(new URL("./fixtures/", import.meta.url));
const svg = (f: string) => readFileSync(FIX + f, "utf8");

/** nameFor: a name build.mjs accepts, from --name or the file name. */
it("takes the name from the file, lowercased and hyphenated, or from --name", () => {
  expect(nameFor("icons/deploy.svg")).toBe("deploy");
  expect(nameFor("My Icon.svg")).toBe("my-icon");
  expect(nameFor("3d-box.svg")).toBe("x3d-box");
  expect(nameFor("a__b..c.svg")).toBe("a-b-c");
  expect(nameFor("deploy.svg", "Rocket")).toBe("rocket");
});

/** scan: what the XML alone says. */
it("reads the viewBox, the title, the ids, the groups and the counts of an icon", () => {
  const info = scan(svg("rocket.svg"), "rocket.svg");
  expect(info).toMatchObject({
    file: "rocket.svg", viewBox: [0, 0, 24, 24], synthesised: false, title: "Deploy",
    ids: ["rocket", "body", "window", "fin-left", "fin-right", "flame"], groups: 2,
    counts: { path: 4, circle: 1 }, notRead: {},
  });
});

it("reads a logo of paths with no title and no ids", () => {
  const info = scan(svg("mark.svg"), "mark.svg");
  expect(info).toMatchObject({ viewBox: [0, 0, 100, 100], title: null, ids: [], groups: 0, counts: { path: 3 }, notRead: {} });
  expect(card(info)).toContain("title: none   ids: none");
});

it("synthesises a viewBox from width and height, skips <defs>, and lists what it does not read", () => {
  const info = scan(svg("mixed.svg"), "mixed.svg");
  expect(info.viewBox).toEqual([0, 0, 48, 32]);
  expect(info.synthesised).toBe(true);
  /* the rect under <defs> and the circle under <symbol> are not painted */
  expect(info.counts).toEqual({ rect: 1 });
  /* a <use> inside the file is a shape by reference; one pointing outside, text and image are not read */
  expect(info.notRead).toEqual({ use: 1, text: 1, image: 1 });
});

it("refuses what has no size and what is not an SVG", () => {
  expect(scan('<svg xmlns="http://www.w3.org/2000/svg"><rect width="1" height="1"/></svg>', "x.svg")).toEqual({ error: "x.svg has no viewBox and no width and height: the card cannot be measured" });
  expect(scan(svg("broken.txt"), "broken.txt")).toEqual({ error: "broken.txt is not an SVG: no <svg> root" });
});

/** relate: one relation per shape, from the boxes alone. */
const ink = { x: 5, y: 2, w: 14, h: 20 };
const S = (i: number, x: number, y: number, w: number, h: number) => ({ i, type: "path", group: null, box: { x, y, w, h }, filled: true, stroke: null, closed: true, kind: "lines" });
it("says inside and where, above or below, left or right, and mirror of", () => {
  const body = S(1, 8, 2, 8, 15), win = S(2, 10.5, 7, 3, 3), finL = S(3, 5, 12, 3, 5), finR = S(4, 16, 12, 3, 5), flame = S(5, 10, 17, 4, 5);
  expect(relate([body, win, finL, finR, flame], ink)).toEqual([
    "",
    "inside #1, middle",
    "left of #1, touching",
    "mirror of #3",
    "below #1, touching",
  ]);
});

it("says nothing for a shape apart from every other", () => {
  expect(relate([S(1, 0, 0, 2, 2), S(2, 50, 50, 2, 2)], { x: 0, y: 0, w: 52, h: 52 })).toEqual(["", ""]);
});

/** card: the text the agent reads. */
it("writes the reduced card from a scan, and says the picture was not taken", () => {
  const text = card(scan(svg("mixed.svg"), "mixed.svg"));
  expect(text.split("\n")[0]).toBe("mixed.svg  viewBox 0 0 48 32 (from width and height)  (1.5:1)  1 shape in 0 groups");
  expect(text).toContain("title: none   ids: clip, dot");
  expect(text).toContain("shapes: 1 rect");
  expect(text).toContain("not read: 1 <use> outside the file, 1 <text>, 1 <image>");
  expect(text).toContain("no browser: boxes and the picture were not taken; read the SVG's own text for them");
});

it("writes the full card with one line per shape, small shapes counted, and 30 lines at most", () => {
  const info = scan(svg("rocket.svg"), "rocket.svg");
  const shapes = [
    { i: 1, type: "path", group: "rocket", box: { x: 8, y: 2, w: 8, h: 15 }, filled: false, stroke: 1.5, closed: true, kind: "curves and lines" },
    { i: 2, type: "circle", group: "rocket", box: { x: 10.5, y: 7, w: 3, h: 3 }, filled: true, stroke: null, closed: true, kind: "curves" },
    { i: 3, type: "path", group: "rocket", box: { x: 5, y: 12, w: 3, h: 5 }, filled: false, stroke: 1.5, closed: true, kind: "lines" },
    { i: 4, type: "path", group: "rocket", box: { x: 16, y: 12, w: 3, h: 5 }, filled: false, stroke: 1.5, closed: true, kind: "lines" },
    { i: 5, type: "path", group: "flame", box: { x: 10, y: 17, w: 4, h: 5 }, filled: true, stroke: null, closed: true, kind: "curves and lines" },
    { i: 6, type: "circle", group: null, box: { x: 0, y: 0, w: 0.1, h: 0.1 }, filled: true, stroke: null, closed: true, kind: "curves" },
  ];
  const text = card(info, shapes);
  const lines = text.split("\n");
  expect(lines[0]).toBe("rocket.svg  viewBox 0 0 24 24  (1:1)  6 shapes in 2 groups");
  expect(lines[1]).toBe("title: \"Deploy\"   ids: rocket, body, window, fin-left, fin-right, flame");
  expect(lines[2]).toBe("ink: 5..19 × 2..22  (58% × 83% of the viewBox)");
  expect(text).toMatch(/^#1 +path +g#rocket +box 8\.\.16 × 2\.\.17  centre 12,9\.5  stroke 1\.5  closed, curves and lines  \(tall, 1:1\.9\)$/m);
  expect(text).toMatch(/^#2 +circle +g#rocket +box 10\.5\.\.13\.5 × 7\.\.10  centre 12,8\.5  filled  closed, curves  inside #1, middle$/m);
  expect(text).toMatch(/^#4 +path +g#rocket +box 16\.\.19 × 12\.\.17  centre 17\.5,14\.5  stroke 1\.5  closed, lines  mirror of #3$/m);
  expect(text).toContain("and 1 small shape");
  expect(lines.length).toBeLessThanOrEqual(30);
  /* forty shapes: the card lists some and counts the rest */
  const many = Array.from({ length: 40 }, (_, k) => ({ ...shapes[0], i: k + 1, box: { x: k, y: 2, w: 8, h: 15 } }));
  const long = card(info, many).split("\n");
  expect(long.length).toBeLessThanOrEqual(30);
  expect(long.at(-1)).toMatch(/^and \d+ more shapes$/);
});

/** Findings of the final review: each pins one failure on a real SVG. */
it("keeps the not-read line on a busy card, under the 30 lines", () => {
  const info = { ...scan(svg("rocket.svg"), "rocket.svg"), notRead: { text: 1 } };
  const rects = Array.from({ length: 30 }, (_, k) => ({ i: k + 1, type: "rect", group: null, box: { x: k * 3, y: 0, w: 2, h: 40 }, filled: true, stroke: null, closed: true, kind: "lines" }));
  const speck = { ...rects[0], i: 31, box: { x: 0, y: 0, w: 0.1, h: 0.1 } };
  const lines = card(info, [...rects, speck]).split("\n");
  expect(lines.length).toBeLessThanOrEqual(30);
  expect(lines).toContain("not read: 1 <text>");
  expect(lines).toContain("and 1 small shape");
});

it("takes width and height in px or absolute units, and refuses % and font units", () => {
  const root = (w: string, h: string) => `<svg xmlns="http://www.w3.org/2000/svg" width="${w}" height="${h}"><rect width="1" height="1"/></svg>`;
  expect(scan(root("24px", "12px"), "a.svg").viewBox).toEqual([0, 0, 24, 12]);
  expect(scan(root("1in", "0.5in"), "a.svg").viewBox).toEqual([0, 0, 96, 48]);
  expect(scan(root("100%", "100%"), "a.svg")).toEqual({ error: "a.svg has no viewBox, and its width and height are in %: the card cannot be measured" });
  expect(scan(root("2em", "2em"), "a.svg")).toEqual({ error: "a.svg has no viewBox, and its width and height are in em: the card cannot be measured" });
});

it("drops a DOCTYPE with an internal subset whole, so nothing of it lands in the picture", () => {
  const html = page(svg("illustrator.svg"), [0, 0, 100, 100]);
  expect(html).not.toContain("]>");
  expect(html).not.toContain("ENTITY");
});

/** Found on a real logo: ink of #FDFDFD vanished on the white picture. */
it("calls the ink light by its colours, weighted by each shape's box", () => {
  const C = (colour: string | null, w: number) => ({ ...S(1, 0, 0, w, w), colour });
  expect(light([C("rgb(253, 253, 253)", 10)])).toBe(true);
  expect(light([C("rgb(24, 24, 27)", 10)])).toBe(false);
  /* a large dark shape with a small light one inside is dark ink */
  expect(light([C("rgb(0, 0, 0)", 10), C("rgb(255, 255, 255)", 3)])).toBe(false);
  /* a white tile carrying a dark glyph is light ink: on white the tile would vanish */
  expect(light([C("rgb(255, 255, 255)", 10), C("rgb(0, 0, 0)", 3)])).toBe(true);
  /* a gradient or nothing known: white, as before */
  expect(light([C(null, 10)])).toBe(false);
  expect(light([])).toBe(false);
});

it("draws the picture on dark when asked, and on white otherwise", () => {
  expect(page(svg("mark.svg"), [0, 0, 100, 100])).toContain("background:#fff");
  const dark = page(svg("mark.svg"), [0, 0, 100, 100], true);
  expect(dark).toContain("background:#18181b");
  expect(dark).not.toContain("background:#fff");
});

it("says on the ink line when the picture is on dark", () => {
  const info = scan(svg("mark.svg"), "mark.svg");
  const shapes = [S(1, 10, 10, 80, 80)];
  expect(card(info, shapes).split("\n")[2]).toBe("ink: 10..90 × 10..90  (80% × 80% of the viewBox)");
  expect(card(info, shapes, true).split("\n")[2]).toBe("ink: 10..90 × 10..90  (80% × 80% of the viewBox)  light ink: the picture is on dark");
});

/** Found on a real logo: one <path> of three subpaths was one shape on the card. */
it("names each part of a path drawn in several pieces", () => {
  const info = scan(svg("mark.svg"), "mark.svg");
  const parts = [{ ...S(1, 2, 2, 6, 6), part: "1 of 2" }, { ...S(2, 12, 2, 6, 6), part: "2 of 2" }];
  expect(card(info, parts)).toMatch(/^#2 +path .* closed, lines, part 2 of 2/m);
});
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall