drawio-skill is a comprehensive toolkit for generating, manipulating, validating, and publishing draw.io architecture diagrams from natural language, codebases, infrastructure-as-code, API specifications, and other structured sources. It provides a unified CLI (`diagramctl.py`) and an optional MCP server (`diagramctl_mcp.py`) that expose workflows for building, syncing, viewing, testing, reviewing, querying, what-if analysis, story generation, and publishing diagrams. The system uses a formal Diagram Intermediate Representation (IR) to separate semantic meaning from geometry, enabling incremental reconciliation, multi-view projection, architecture contract enforcement, and accessible HTML story output. It includes 15+ importers for languages (Python, JS, Go, Rust), IaC (Terraform, Kubernetes, Docker Compose), schemas (SQL, OpenAPI, AsyncAPI, Protobuf, GraphQL), and live infrastructure (Docker, Terraform state). The project is packaged as an AI agent skill compatible with Claude Code, Cursor, Copilot, and other Agent Skills hosts, and ships with GitHub Actions for CI integration. While primarily an application, it also bundles curated icon indices and style presets that could be considered data assets.
This repository is a curated collection of reusable draw.io shape libraries, editable diagram examples, and a Docusaurus-based guideline website for creating consistent SAP Business Technology Platform (BTP) solution architecture diagrams. It provides standardized icons for SAP BTP services (organized by category and size), connectors, area shapes, text elements, brand logos, and pre-built diagram templates (e.g., SAP Task Center, SAP Cloud Identity Services, SAP Private Link Service). The guideline website documents design principles, atomic components, and best practices for diagram creation. The repository is not a runnable application but a design asset library with a static site for documentation. It serves SAP solution architects and technical writers who need to produce professional, on-brand architecture diagrams.