All skills
aktsmm avatar

/archify

@40d4cd7
by yamapanaktsmm/agent-skills26 stars
4

Create polished, validated architecture, workflow, sequence, data-flow, and lifecycle/state diagrams as explorable standalone HTML with inline SVG, dark/light themes, optional trace motion, and PNG/JPEG/WebP/SVG/WebM export. Accept plain-language requirements or pasted Mermaid flowchart, sequenceDiagram, and stateDiagram input; inspect repository evidence when the diagram must reflect real code. Use when the user asks to visualize system architecture, infrastructure, cloud/security/network topology, technical workflows, API call sequences, request lifecycles, data pipelines, ETL/ELT, data lineage, state machines, or to convert/beautify Mermaid. Also use for Archify, interactive or animated HTML diagrams, インタラクティブ図, 動く構成図. When an editable .drawio file is required, use the draw.io workflow instead and treat Archify HTML only as a supplement.

  • 105 files
  • 3.4 MB
  • MIT
  • Updated 3 days ago
  • GitHub

Use this Skill: https://skilld.dev/gh/aktsmm/agent-skills/archify

This session only. Nothing lands on disk.

referencesviewer-runtime.md

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

Viewer Runtime reference

Read this only when the user asks for a reader-facing capability. Ordinary generation does not require implementing or re-documenting these features; they are already in the generated HTML.

Exploration

  • Diagram Guide lists current actions and shortcuts.
  • Reading Depth starts at READ at the default 100% scale, reveals FULL detail at 175%, and falls back to MAP only below 100%. Focus, route, and semantic interactions reveal their exact facts at any scale.
  • Semantic Lens summarizes selected node/relationship kinds without changing authored geometry.
  • Intent Trace previews a fine-pointer or keyboard target before committed focus.
  • Node Finder searches labels and stable IDs.
  • Semantic Passport opens on focus, shows authored upstream/downstream facts, supports a copyable deep link, has an explicit close action, closes on true outside activation and Escape, and never enters canonical export.
  • Semantic Radar mirrors the visible viewport and authored graph without becoming a second source of truth.
  • Direct Relationship Pin makes a unique compiled relationship operable while preserving the authored line and stable relationship identity. It must fail closed on conflicting source/target/label/ID metadata.
  • Route Probe resolves exactly two endpoints over authored directed relationships. It never infers a route from geometry.

Motion and presentation

meta.animation: "trace" enables a finite reader-controlled Live/Still trace. Static is the default. Still, reduced motion, page hiding, print, and canonical export preserve complete static meaning. Presentation Stage changes viewer chrome and framing, never authored geometry. This is not a mobile product feature; narrow layouts get containment only.

Canonical exports

The export menu can copy/download full-diagram PNG, download JPEG/WebP, download a dual-theme SVG, and record a trace-enabled WebM. Viewer state—Guide, Lens, finder, focus, route, camera, radar, presentation, motion ownership, and temporary overlays—must be removed from canonical export.

Route Share Card

After a real directed Route Probe resolves, the reader may use Export → Route Share Card. It reuses the exact ordered route snapshot and the shared Share Card seam: format=share-card, variant=route. The isolated clone may use only static data-share-route-* decoration. It is download-only, fails closed for stale/unreachable/conflicting routes, and never becomes the canonical artifact.

Reach Share Card

After a non-empty authored reachability query, the reader may use Export → Reach Share Card. It consumes the already resolved upstream/downstream node and edge set without rerunning traversal: format=share-card, variant=reach. The isolated clone may use only static data-share-reach-* decoration. It is download-only. Call it authored reachability—not impact, blast radius, breakage, or runtime causality.

Truth boundary

Viewer exports are communication assets. They do not replace the checked HTML, the deterministic delivery receipt, or a real visual review. Do not add a hosted service, storage surface, dependency, schema branch, or mobile product surface for these viewer-only capabilities.

Source: SKILL.md on GitHub

No third-party reports yet.

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

Last checked against GitHub yesterday.

Activeupdated 3 days ago
Other metadata
metadata
{
  "version": "3.0",
  "author": "tt-a1i",
  "based_on": "Cocoon-AI/architecture-diagram-generator (MIT, v1.0)"
}

README badge

README badge for aktsmm/agent-skills/archify