c4-diagram-creator

Generate C1–C4 PlantUML diagrams from a Feature Design Document.

Updated Apr 16, 2026
One-click install
npx skills add https://github.com/tassosgomes/poc-iam-service --skill c4-diagram-creator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: c4-diagram-creator
Source: https://github.com/tassosgomes/poc-iam-service/tree/main/.github/skills/common/c4-diagram-creator
Command: npx skills add https://github.com/tassosgomes/poc-iam-service --skill c4-diagram-creator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the generation of C4 diagrams (System Context, Container, Component and Code) from a Feature Design Document (FDD) or similar technical documentation. It enables architectural visualization and design documentation by producing consistent PlantUML diagrams.

Core Features & Use Cases

  • Generate C1–C4 diagrams from an FDD, preserving the FDD language and terminology.
  • Output PlantUML files with UTF-8 encoding to preserve accents and special characters.
  • Produce a Markdown analysis file for the C4 diagram set without including PlantUML code.
  • Enforce consistent layout, notation, and notes across all diagram levels.

Quick Start

Provide the FDD path and the desired output folder; the tool will generate C1–C4 diagrams in PlantUML under that folder.

Frequently Asked Questions about c4-diagram-creator

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

FAQPage Schema
How do I generate C4 architecture diagrams from a Feature Design Document?

Generating C4 diagrams from an FDD requires providing the FDD file path and a target output folder. The tool then produces PlantUML files for C1–C4 levels, ensuring language consistency with the source document and conforming to C4 best practices.

What is the best way to automate PlantUML generation for C4 system context and container views?

The best way to automate PlantUML generation for C4 views is using an FDD as input. The process creates UTF-8 encoded PlantUML files for C1–C4 diagrams, enforcing consistent layout, notation, and notes across all architecture levels.

Do I need a specific Feature Design Document format to create C1–C4 diagrams?

You need an existing Feature Design Document or similar technical documentation to create C1–C4 diagrams. The tool uses the FDD to ensure language consistency and applies C4 best practices to generate the full set of architecture visualizations.

Does this C4 diagram generator output Markdown analysis alongside PlantUML files?

The C4 diagram generator outputs a Markdown analysis file alongside UTF-8 encoded PlantUML files. This Markdown file documents the C4 diagram set without including any PlantUML code, providing a clean architectural overview.

Why does my PlantUML output lose special characters when generating C4 diagrams?

PlantUML output loses special characters when generating C4 diagrams if UTF-8 encoding is not enforced. This tool explicitly outputs PlantUML files with UTF-8 encoding to preserve accents and special characters from the source FDD.