arch-diagram-generator

Generate architecture diagrams from code or documentation via Gemini API.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/zjh08177/agent-harness --skill arch-diagram-generator
Or copy as Structured Prompt for Agent
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.