Index of every page on this site: llms.txt
All skills
tt-a1i avatar
by tt-a1itt-a1i/archify93k stars
6,337
Run it yourself

Create validated architecture, workflow, sequence, data-flow, lifecycle/state, ERD, class, tree, timeline, and waterfall diagrams as explorable standalone HTML with dark/light themes, motion and image/SVG/WebM export. Accept requirements or Mermaid; inspect repository evidence for code-backed diagrams. Use when visualizing systems, API calls, pipelines, schemas, histories, timings, or everyday steps, parts, relationships and states. Also turn an answer into a one-page explainer, with the conclusion first, structured panels, native diagrams and charts, when the user asks for a page, an explainer or an answer to share (做成一页, 用页面讲), or proactively when the user's rules opt in with an [archify explainer: ...] line. Not for dashboards.

Recorded with Claude Code, Opus 5.5

Prompt

Draw an architecture diagram for Ferncastle, a fictional library app: phone app, API gateway, auth service, catalog service, holds queue, search index, Postgres, and push notifier. Show how a book reservation flows through it. Save it as one self-contained diagram.html with all CSS and JavaScript inline.

Desktop screenshot of the page the Agent built for: Draw an architecture diagram for Ferncastle, a fictional library app: phone app, API gateway, auth service, catalog serv

Recorded on an older version of this Skill.

Use this Skill: https://skilld.dev/gh/tt-a1i/archify/archify

Nothing lands on disk. Nothing to clean up.

Fork this Skill

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

referencesbrand-marks.md

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

Brand marks

Use a brand mark only when a real product, provider, model family, channel, or service identity helps the reader. Semantic type still explains what the node does; brand explains whose product it is.

Agent decision path

  1. Search the built-in catalogue when the request names a recognizable brand:

    node bin/archify.mjs brands "Claude" --json
  2. Put the returned canonical ID in the node, participant, or state:

    {
      "id": "planner",
      "type": "backend",
      "label": "Claude",
      "brand": "claude"
    }
  3. If there is no catalogue match and the user supplied the official website, capture its icon explicitly:

    node bin/archify.mjs brands capture "https://partner.example.com" --json

    Put the command's digest-pinned brand value in the authored node:

    {
      "id": "partner",
      "type": "external",
      "label": "Partner portal",
      "brand": {
        "url": "https://partner.example.com",
        "sha256": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
      }
    }
  4. If there is no match and no user-provided URL, omit brand. Do not invent a URL or silently assign a visually similar company.

Known-brand URLs resolve to the bundled vector instead of using the network. For discovered icon href attributes, capture decodes the basic named references amp, quot, apos, lt, gt (and their defined uppercase aliases), plus decimal and hexadecimal numeric references, once before URL resolution. Thus /icon.png?v=1&amp;size=32 requests /icon.png?v=1&size=32. URL percent escapes remain intact; nested escapes are not decoded recursively. This bounded decoder does not add a general HTML parser or support every named HTML entity. HTML reads stop at an explicit head ending outside comments, raw-text elements and quoted attributes, including when those tokens span network chunks. The 256 KiB head limit and capture deadline still apply; a larger body after the head is not read for icon discovery. Icon candidates come from complete link tags outside comments, raw text and template contents. Attribute values and lookalike names such as data-href cannot supply icon declarations; quoted > characters stay within their tags. For text/html, discovery treats noscript contents as raw text, matching scripting-enabled HTML parsing; capture does not execute scripts. This exclusion does not apply to application/xhtml+xml, where noscript links remain discoverable. XHTML empty elements such as <script /> and <template /> do not hide following links; the same trailing slash does not close those elements in text/html. Unknown URL capture accepts only bounded raster image formats, blocks credentials, nonstandard public ports, and private or link-local destinations, uses bounded concurrency and one total deadline, and returns the captured content digest. Later render and validate operations require that exact digest; blocked, unavailable, changed, oversized, or unsafe content fails closed instead of silently changing the artifact.

Remote-brand provenance in capture receipts, node metadata and SVG/HTML keeps the source URL's HTTP(S) scheme, host, port and path, but omits userinfo, query strings and fragments. The authored brand.url and all download/redirect URLs remain unchanged so existing pins still reproduce the same bytes and digest. Credential-bearing download URLs remain rejected. Built-in marks retain their recorded catalogue provenance.

The public source link identifies the original site/path, not necessarily a downloadable asset: removing a signed query or a query-based page selector can make that link unusable or less specific. Prefer capturing a stable public landing page that exposes the intended icon when one is available; do not edit an existing pin's URL without capturing and verifying that source again. Paths are retained, so this normalization is not a general URL-secret scrubber.

After upgrading from a version that captured inactive HTML markup (including noscript), an existing URL pin may fail with brand/digest-mismatch because discovery now selects a different icon. Inspect the intended icon, rerun the capture command above for the same URL, and explicitly replace the authored brand value with the returned pin. Existing pins are not rewritten automatically, and digest verification remains enforced.

For ICO captures, every directory entry must reference a non-empty image range after the complete directory and within the downloaded file. This bounds check also applies when reproducing a pinned capture. PNG/DIB payloads, multiple images, shared or out-of-order ranges, and trailing bytes remain supported; the check does not decode pixels or guarantee that an otherwise bounded payload is decodable. A rejected ICO candidate does not prevent trying later icons.

Page, icon and redirect requests send Accept-Encoding: identity. Capture does not decompress response bodies: a successful response declaring another content coding is closed and rejected explicitly. This keeps the existing byte limits and pinned digest tied to the unencoded representation. A later usable icon may still succeed; otherwise an encoding error is retained instead of being hidden by an unrelated favicon 404.

The final artifact never fetches a brand asset when opened. Preset vectors and digest-verified captured site icons remain embedded in SVG, PNG, WebP, JPEG, Share Card, and WebM exports.

Use node bin/archify.mjs brands --json to inspect all canonical IDs, aliases, categories, domains, and provenance. Current categories cover AI, cloud, engineering, data, collaboration, business systems, channels, languages, and frameworks.

Source: SKILL.md on GitHub

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 alerts5d3 checks · Risk SAFE
  • Gen Agent Trust Hub5d

    The Archify skill provides a comprehensive suite for generating technical diagrams and explainer pages. It demonstrates a high standard of security engineering, featuring robust protections against Time-of-Check to Time-of-Use (TOCTOU) filesystem attacks, SSRF-guarded network requests for external icons, and command-injection-resistant process execution. It includes built-in logic to scan for and redact secrets in processed data.

  • Socket5d

    No alerts

  • Snyk5d

    Risk: LOW · No issues

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

Last checked against GitHub last week.

Activeupdated 2 weeks ago
metadata
{
  "version": "3.2",
  "author": "tt-a1i"
}

README badge

README badge for tt-a1i/archify