Verified:GitHub

arch-diagram-generator

Generate architecture diagrams from code or documentation via Gemini API.

Updated Aug 27, 2026

Search Tags:#code-analysis #diagram-generation #gemini-api #architecture-visualization #arch-diagram #ai-diagram #json-extraction

Ready to run

npx skills add https://github.com/zjh08177/agent-harness --skill arch-diagram-generator

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: arch-diagram-generator
Source: https://github.com/zjh08177/agent-harness/tree/main/skills/arch-diagram-generator
Command: npx skills add https://github.com/zjh08177/agent-harness --skill arch-diagram-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, curl, base64, date, and includes scripts (resource) components.

What problem does it solve?

Visualizing complex software architectures from code and documentation can be time-consuming and error-prone. This skill automatically derives a structured diagram-ready representation from your project, accelerating architectural discovery and communication.

Core Features & Use Cases

Extract architecture from code repositories or documentation and produce a JSON model suitable for diagram generation.
Generate diagrams via Gemini API with configurable styles, ensuring consistent visuals across projects.
Support quick onboarding with a reusable frontmatter-driven discovery workflow for Claude Code integrations.

Quick Start

Run the included script on a project to generate an architecture diagram.

Frequently Asked Questions about arch-diagram-generator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I generate an architecture diagram from code repositories?▼

You can generate architecture diagrams from markdown documentation by deriving a structured JSON model from the text and feeding it to the Gemini API. This produces a diagram image with customizable styles for visual communication.

Do I need a Gemini API key to visualize software architecture?▼

Yes, you need Gemini API access to visualize software architecture, as the diagram image is generated via the Gemini API. The skill validates this prerequisite along with necessary helper scripts before processing your code or documentation.

Can I customize the visual style of generated architecture diagrams?▼

Yes, you can customize the visual style of generated architecture diagrams via configurable options sent to the Gemini API. This ensures consistent visuals across different projects when deriving diagrams from your JSON models.

What is the best way to extract a diagram-ready JSON model from existing code?▼

The best way to extract a diagram-ready JSON model is using a skill that automatically derives a structured representation from your project files. It provides a reusable JSON schema to ensure the extracted data is properly formatted for diagram generation.

What limitations exist when using shell scripts for architecture visualization?▼

Limitations for architecture visualization include dependencies on shell utilities like jq, curl, and base64. If these helper scripts or Gemini API access are unavailable, the skill cannot validate prerequisites or generate the diagram image.