hermes-agent/website/docs/user-guide/skills/optional/creative/creative-archify.md
treatux 2a1ec15a6f docs(website): regenerate the skill docs from the shipped skill tree
website/scripts/generate-skill-docs.py is the documented source of both catalogs
and of the per-skill pages, but nothing compares its output with what is
committed, so the committed copies drifted:

- optional-skills-catalog.md was missing agent-merge-conflict-arbiter and listed
  pr-lens under blockchain (it lives in software-development);
- skills-catalog.md still listed merge-reconciler, which #98539 moved out of the
  bundled set;
- 196 pages and both catalogs carried Windows path separators — in the Path
  column and inside GitHub blob links, where a backslash is a broken URL.

This commit is the generator's output (re-running it on this branch is a no-op),
plus the orphan page #98539 left behind for merge-reconciler: no skill backs it,
its catalog row is gone, and no page links to it.

tests/skills/test_skill_docs_contract.py is the guard: the next skill that ships
without a catalog row, or a page regenerated on Windows, fails there instead of
on the published page.
2026-09-20 12:54:07 -07:00

3.2 KiB

title sidebar_label description
Archify — Validated interactive HTML diagrams, upstream-maintained Archify Validated interactive HTML diagrams, upstream-maintained

{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}

Archify

Validated interactive HTML diagrams, upstream-maintained.

Skill metadata

Source Optional — install with hermes skills install official/creative/archify
Path optional-skills/creative/archify
Version 2.17.0
Author tt-a1i
License MIT
Platforms linux, macos, windows
Tags diagram, architecture, workflow, sequence, dataflow, state-machine, mermaid, html, svg
Related skills architecture-diagram, excalidraw, concept-diagrams

Reference: full SKILL.md

:::info The following is the complete skill definition that Hermes loads when this skill is triggered. This is what the agent sees as instructions when the skill is active. :::

Archify (upstream-maintained)

Catalog stub. This entry is maintained upstream at tt-a1i/archify: the project ships a self-contained skill directory (archify/) with the Node CLI, schemas, renderers, examples and references. hermes skills install official/creative/archify pulls the current tree live from that repo (quarantined and scanned like any hub install) — this directory holds only the catalog metadata, so the vendored copy can never go stale.

Archify turns a small typed JSON spec into a self-contained, explorable HTML diagram: architecture, workflow, sequence, dataflow and lifecycle (state machine) types, dark/light themes, pan/zoom, search, relationship tracing, optional trace motion, and PNG/JPEG/WebP/SVG/WebM export. It accepts plain-language requirements or pasted Mermaid (flowchart, sequenceDiagram, stateDiagram) and can read repository evidence when the diagram must reflect real code. Every candidate goes through a 9-check validate / deliver receipt, so the output is verifiable rather than eyeballed.

Prerequisites

  • Node.js 18+ on PATH (node bin/archify.mjs doctor confirms the install; no npm install is needed inside the skill package).
  • Installs pull ~200 files (~8 MB, mostly upstream tests and examples) from GitHub; the fetch is pinned to one tree SHA, recorded in the bundle metadata.
  • Upstream's "Update awareness" step runs scripts/check-update.mjs, which reads a release manifest from GitHub and only prints a notice — it never downloads or installs anything. Skip it if outbound calls are unwanted.

After install, the bundled architecture-diagram skill remains the zero-dependency fallback (it ports the same Cocoon AI lineage archify grew out of); prefer archify when the user wants validated receipts, Mermaid conversion, sequence/lifecycle types, or export beyond a single HTML file.

Full documentation: https://github.com/tt-a1i/archify#readme