BeClaude

archik

New
1knpmGeneralMIT

The shared vocabulary between you and Claude Code, at the engineering level. Plain-YAML architecture diagrams with a live browser canvas, headless SVG render in CI, and an installable Claude skill so the model treats the diagram as the spec.

First seen 5/22/2026

Summary

Archik establishes a shared vocabulary between you and Claude Code for architecture diagrams, using plain-YAML files that render as live SVG in the browser or headlessly in CI.

  • It treats the diagram as the spec, enabling the model to understand and modify your system architecture directly from the codebase.

Install & Usage

1
Create the skills directory
mkdir -p .claude/skills
2
Download the skill file
mkdir -p .claude/skills && curl -o .claude/skills/archik.md https://raw.githubusercontent.com/bacharSalleh/archik.git/main/SKILL.md
3
Invoke in Claude Code
/archik

Use Cases

Generate a YAML-based architecture diagram from a natural language description of your system components and their relationships.
Update an existing architecture diagram by describing a new service or connection, and have the YAML and SVG automatically synchronized.
Render architecture diagrams as SVG in CI pipelines to include in documentation or pull request comments.
Use the live browser canvas to collaboratively explore and refine system architecture during design reviews.
Parse existing code or configuration files to infer and generate an initial architecture diagram in YAML format.
Validate that a proposed architecture change is consistent with the current diagram before implementing it.

Usage Examples

1

/archik create a diagram showing a frontend React app, a Node.js API, and a PostgreSQL database with arrows for data flow

2

/archik add a Redis cache layer between the API and database in the current architecture diagram

3

/archik render the diagram as SVG and save it to docs/architecture.svg

View source on GitHub
architecturediagramyamlelksvgclidocumentationclaude

Security Audits

LicensePassSourceWarnRepositoryPass

Frequently Asked Questions

What is archik?

Archik establishes a shared vocabulary between you and Claude Code for architecture diagrams, using plain-YAML files that render as live SVG in the browser or headlessly in CI. It treats the diagram as the spec, enabling the model to understand and modify your system architecture directly from the codebase.

How to install archik?

To install archik: create the skills directory (mkdir -p .claude/skills), then run: mkdir -p .claude/skills && curl -o .claude/skills/archik.md https://raw.githubusercontent.com/bacharSalleh/archik.git/main/SKILL.md. Finally, /archik in Claude Code.

What is archik best for?

archik is a skill categorized under General. It is designed for: architecture, diagram, yaml, elk, svg, cli, documentation, claude.

What can I use archik for?

archik is useful for: Generate a YAML-based architecture diagram from a natural language description of your system components and their relationships.; Update an existing architecture diagram by describing a new service or connection, and have the YAML and SVG automatically synchronized.; Render architecture diagrams as SVG in CI pipelines to include in documentation or pull request comments.; Use the live browser canvas to collaboratively explore and refine system architecture during design reviews.; Parse existing code or configuration files to infer and generate an initial architecture diagram in YAML format.; Validate that a proposed architecture change is consistent with the current diagram before implementing it..