Skip to content

Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.

fix: keep skill metadata portable (#32)

tt-a1i6207e0854485
diff --git a/CHANGELOG.md b/CHANGELOG.md
index c342ee31..0141802e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -67,6 +67,7 @@ All notable changes are documented here. Format loosely follows [Keep a Changelo
- Generated diagrams support `?embed=1`, a chrome-free read-only surface used by the live gallery previews.
### Fixed
+- The Skill frontmatter description now stays within the 1024-character metadata limit used by GitHub Copilot and other Agent Skill runtimes, while retaining all five diagram-mode and Mermaid discovery triggers. A regression test protects both the portable size budget and searchable trigger vocabulary.
- Clean Flow is now a universal semantic correctness invariant instead of an opt-in composition gate. Profile-less default rendering rejects a relationship whose routed geometry passes through an unrelated opaque node, including the real auto-route regression from #24, while explicit waypoints around the obstacle remain valid. `standard` and `showcase` still control only the stricter composition budgets.
- East Asian text measurement now includes wide vertical punctuation and supplementary script blocks while keeping halfwidth Katakana at one unit. Regression coverage preserves Hiragana, Katakana, Bopomofo, Hangul compatibility letters, fullwidth forms, emoji, and supplementary CJK behavior.
- WebM export now renders an explicit time-varying canvas scene over the static canonical diagram instead of repeatedly drawing one browser-cached SVG image frame. Signals follow the real authored `path` / `line` / `polyline` geometry, node pulses retain authored order, and the six-second browser-native recording is visibly animated without mutating the SVG, adding dependencies, or leaking viewer state.
diff --git a/archify.zip b/archify.zip
index 3c74b79d..0ce82e9d 100644
Binary files a/archify.zip and b/archify.zip differ
diff --git a/archify/SKILL.md b/archify/SKILL.md
index 1ffba020..4a641352 100644
--- a/archify/SKILL.md
+++ b/archify/SKILL.md
@@ -1,6 +1,6 @@
---
name: archify
-description: Create professional architecture, workflow, sequence, data-flow, and lifecycle/state diagrams as explorable standalone HTML files with SVG graphics, progressive MAP/READ/FULL Reading Depth, selective counted inline legends that enter a Semantic Lens with selection-triggered direction signals, directly operable and shareable stable relationships, exact-edge one-shot Relationship Preview pulses, pre-click Intent Trace path previews, two-endpoint Route Probe analysis, searchable semantic nodes, focus with Semantic Passport context, a live Semantic Radar overview, a Named Chapter Rail with pre-commit Chapter Delta Preview, Shared Anchor Handoff, a directly inspectable Story Beat Navigator with Story Follow Camera, factual Story Director Strip, and one-step Story Horizon, stable Shareable Story Moment links, a reader-controlled Live/Still Motion Governor, Presentation Stage, dependency-free pan/zoom, dark/light themes, optional motion styling, and one-click export to PNG / JPEG / WebP / SVG / WebM. Accepts plain-language descriptions or pasted Mermaid code (flowchart, sequenceDiagram, stateDiagram) and lays the diagram out from scratch in archify style. Use when the user asks for system architecture diagrams, infrastructure diagrams, cloud architecture visualizations, security diagrams, network topology, technical workflows, approval flows, runbooks, CI/CD flows, process diagrams, API call sequences, request lifecycles, data pipelines, ETL/ELT maps, PII boundaries, data lineage, state machines, lifecycle diagrams, status transitions, or asks to convert/beautify a Mermaid diagram.
+description: Create polished, validated architecture, workflow, sequence, data-flow, and lifecycle/state diagrams as explorable standalone HTML with inline SVG, dark/light themes, semantic navigation, 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, approval or CI/CD flows, API call sequences, request lifecycles, data pipelines, ETL/ELT, data lineage, state machines, or to convert/beautify Mermaid. Prefer typed JSON IR renderers and deterministic validation; deliver static output by default and enable motion only when requested.
license: MIT
metadata:
version: "2.11"
diff --git a/archify/test/skill-metadata.test.mjs b/archify/test/skill-metadata.test.mjs
new file mode 100644
index 00000000..9675de99
--- /dev/null
+++ b/archify/test/skill-metadata.test.mjs
@@ -0,0 +1,23 @@
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import test from 'node:test';
+import assert from 'node:assert/strict';
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const skill = readFileSync(path.join(here, '..', 'SKILL.md'), 'utf8');
+const frontmatter = skill.match(/^---\n([\s\S]*?)\n---/);
+
+test('skill description is portable across 1024-character runtimes and remains searchable', () => {
+ assert.ok(frontmatter, 'SKILL.md must start with YAML frontmatter');
+ const description = frontmatter[1].match(/^description:\s*(.+)$/m)?.[1]?.trim();
+ assert.ok(description, 'frontmatter must include a one-line description');
+ assert.ok(description.length <= 1024, `description is ${description.length} characters; maximum is 1024`);
+ assert.ok(Buffer.byteLength(description, 'utf8') <= 1024, 'description must also fit a 1024-byte runtime limit');
+
+ for (const trigger of ['architecture', 'workflow', 'sequence', 'data-flow', 'lifecycle', 'Mermaid']) {
+ assert.match(description, new RegExp(`\\b${trigger}\\b`, 'i'), `description must retain the ${trigger} trigger`);
+ }
+ assert.match(description, /standalone HTML/i);
+ assert.match(description, /Use when/i);
+});