README and SKILL.md: install with npx skills add, update with npx skills update; one copy per machine

This commit is contained in:
root-at-skic committed 2026-10-20 21:06:31 +03:00
1 parent abb4eb279f
commit 86933dcaf1
2 files changed
+12 -1

No files matched your search

+11
View File
@@ -2,6 +2,17 @@
Agent Skill for Archify diagrams and models as read by the [Archify Diagram Viewer](https://marketplace.visualstudio.com/items?itemName=root-at-skic.archify-vscode-ext) 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, …):
```bash
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:
```bash
+1 -1
View File
@@ -28,7 +28,7 @@ Write diagrams as text next to the code, in the form the Archify Diagram Viewer
Archify (MIT, by tt-a1i) is the renderer and validator. The extension bundles it; so does this skill (`scripts/vendor/archify`), so every task here runs on plain Node and needs nothing installed. The model layer (registry, `ref`, `diagram:` links) is the extension's; this skill resolves it the same way the extension does before Archify sees a diagram. Every task prints YAML on stdout (`success: true|false` first) and logs to stderr.
All tasks run from this skill's `scripts/` folder:
Install with `npx skills add https://gitea.lego-cloud.eu/vscode-extensions-skills/archify-vscode-ext.git --global`, update with `npx skills update --global`; or clone and `git pull`. One copy per machine. All tasks run from this skill's `scripts/` folder:
```bash
cd <this-skill>/scripts