Agent Skill for Archify diagrams and models as read by the Archify Diagram Viewer VS Code extension: how to write .archify diagrams (architecture, workflow, sequence, dataflow, lifecycle), how to put them together as a model (main.archify, shared elements in *.archify-registry files, ref: components, diagram: links, C4-style folders), and tasks that validate, list, scaffold, resolve and render them. The Archify validator and renderer (MIT, by tt-a1i) are bundled under scripts/vendor, so nothing else needs to be installed.

Install and update

One command, any agent (Claude Code, Codex, Copilot, Cline, …):

npx skills add https://gitea.lego-cloud.eu/vscode-extensions-skills/archify-vscode-ext.git --global --agent claude-code,codex,github-copilot,cline
npx skills update --global

Or clone the repository into your agent's skills folder (~/.claude/skills, ~/.agents/skills) and git pull to update. Keep one copy per machine: a skill installed twice is offered to the agent twice. The bundled Archify version is printed by every task model:validate run (archify: 3.0.1), so a stale copy is easy to spot.

Quick start:

cd scripts
task model:scaffold -- --dir="/path/to/online-shop" --id="online-shop" --name="Online Shop" --c4
task model:validate -- --dir="/path/to/online-shop"
task diagram:render  -- --file="/path/to/online-shop/0200-containers/online-shop.archify" --out="/tmp/containers.html"

See SKILL.md for the workflow, the task table and the gotchas. examples/ holds three complete models that validate (C4 - Standard Web App, C4 - E-Shop, C4 - Event-Based Integration); task model:scaffold -- --dir="…" --example="c4-e-shop" copies one.

Requires Node.js 18+, bash and go-task. The skill targets the Archify Diagram Viewer extension; a diagram that validates here opens the same way in VS Code.

Support

If this saves you time, you can buy me a coffee: https://buymeacoffee.com/root.at.skic