HK-hub/AgentSkills / archify
archify
FlaggedCreate 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, an optional 1200×630 Share Card PNG, 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, enable motion only when requested, and use optional post-commit opening only for an interactive local handoff.
test/preview-contract.test.mjs
View on GitHubimport fs 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 skillRoot = path.resolve(here, '..');
const repoRoot = path.resolve(skillRoot, '..');
const skill = fs.readFileSync(path.join(skillRoot, 'SKILL.md'), 'utf8');
const readme = fs.readFileSync(path.join(repoRoot, 'README.md'), 'utf8');
const english = fs.readFileSync(path.join(repoRoot, 'README_EN.md'), 'utf8');
const chinese = fs.readFileSync(path.join(repoRoot, 'README_ZH.md'), 'utf8');
const roadmap = fs.readFileSync(path.join(repoRoot, 'ROADMAP.md'), 'utf8');
test('preview contract: the skill keeps live preview explicit, desktop-only, and last-good', () => {
assert.match(skill, /archify\.mjs preview <type> <input>\.json <output>\.html/);
assert.match(skill, /active desktop authoring loop/i);
assert.match(skill, /previous verified revision remains on screen and on disk/i);
assert.match(skill, /never start it by default/i);
assert.match(skill, /CI, unattended agents, remote sharing, or mobile use/i);
assert.match(skill, /must never enter the generated artifact or any export/i);
});
test('preview contract: all README languages document the same optional command without changing the hero', () => {
assert.equal(readme, english);
for (const text of [readme, chinese]) {
assert.match(text, /bin\/archify\.mjs preview workflow/);
assert.match(text, /--no-open/);
assert.match(text, /127\.0\.0\.1/);
assert.match(text, /Ctrl-C/);
assert.match(text, /docs\/assets\/archify-readme-hero\.png/);
}
});
test('preview contract: roadmap records the no-leak and zero-dependency boundary', () => {
assert.match(roadmap, /Last-Good Live Preview/);
assert.match(roadmap, /installed ZIP skills keep the zero-dependency contract/i);
assert.match(roadmap, /no server state, port, path, error, or reload token enters HTML/i);
});
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |