oci-drawio-architect

oci-drawio-architect is a skill for Claude Code from sergio-farfan/OCI-draw.io-Architect. It costs 47 tokens per session (3,788 once invoked), scanned A, original, MIT.

A tool-assisted method for creating draw.io architecture diagrams for Oracle Cloud Infrastructure, Oracle's cloud platform. It uses Oracle's cloud icons and diagram styles to show regions, networks, subnets, services, and on-premises systems.

In plain words
What is it for?
Drawing OCI network layouts, showing where cloud services run, visualizing Terraform-based architectures, and connecting cloud and on-premises components.
Why use it?
It gives teams a consistent way to turn an OCI design or configuration into a readable architecture diagram.

Skill for Claude Code

Written for Claude Code: ${CLAUDE_PLUGIN_ROOT} variable.

Runs only inside its plugin — its command needs a path that Claude Code sets for a plugin’s own hooks and for nothing else. Install the plugin, not this.

Part of the oci-drawio-architect plugin — 1 skill, 1 command shipped together

Good fit Drawing OCI network layouts, showing where cloud services run, visualizing Terraform-based architectures, and connecting cloud and on-premises components.

Compare 6 skills from other repositories ↓
Install

Getting it into your agent

This one installs as part of its plugin. Adding the marketplace and installing the plugin brings it with everything else the plugin ships.

Claude Code
/plugin marketplace add sergio-farfan/OCI-draw.io-Architect
Claude Code
/plugin install oci-drawio-architect

Made for: Claude Code.

Or install oci-drawio-architect, the plugin that ships this one along with the rest of its 1 skill, 1 command.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for oci-drawio-architect

README.md
[![agentmods](https://agentmods.dev/badge/skills/sergio-farfan/oci-draw.io-architect/oci-drawio-architect/github.svg)](https://agentmods.dev/skills/sergio-farfan/oci-draw.io-architect/oci-drawio-architect)
Your own site
<a href="https://agentmods.dev/skills/sergio-farfan/oci-draw.io-architect/oci-drawio-architect"><img src="https://agentmods.dev/badge/skills/sergio-farfan/oci-draw.io-architect/oci-drawio-architect/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for oci-drawio-architect

Your own site · 80×15
<a href="https://agentmods.dev/skills/sergio-farfan/oci-draw.io-architect/oci-drawio-architect"><img src="https://agentmods.dev/badge/skills/sergio-farfan/oci-draw.io-architect/oci-drawio-architect.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 47 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,788 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00047 $0.03788
Opus 5 $0.00023 $0.01894
Sonnet 5 $0.00009 $0.00758
Haiku 4.5 $0.00005 $0.00379

Measured 12d ago against content hash 9d8001a68941, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

oci-drawio-architect scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

1. **Using a raw base64 data URI** - `image=data:image/png;base64,iVBOR...` gets truncated at the `;base64,` marker because draw.io/mxGraph splits cell styles on `;`. Always URL-encode instead: `image=data:image/svg+xml,
oci-drawio-architect/skills/oci-drawio-architect/SKILL.md · 280 lines

How it starts

The opening of the file, as written. The whole thing — 280 lines — stays where its author put it; the contents beside it link to each section on GitHub.

OCI draw.io Architecture Diagrams

Generate production-quality draw.io diagrams for Oracle Cloud Infrastructure using Python, embedded OCI SVG icons, and Oracle template styles.

Overview

This skill provides a battle-tested DrawioBuilder Python class that produces .drawio XML files with:

  • Embedded OCI SVG icons (URL-encoded, single-cell, clean rendering)
  • Oracle template container styles (Region, VCN, Subnet, Services, On-Premises)
  • PNG logo embedding via SVG wrapper trick
  • Orthogonal-router edges by default, with explicit ports/waypoints available for tight control

Core principle: Copy drawio_builder.py into your script, write a build_diagram() function that places containers/icons on a grid, then let the orthogonal router connect them — explicit ports/waypoints only where tight control is needed.

DrawioBuilder script location: ${CLAUDE_PLUGIN_ROOT}/scripts/drawio_builder.py

When to Use

  • Generating a draw.io diagram for any OCI architecture
  • Visualizing VCN topology, subnets, and service placement
  • Creating architecture diagrams from Terraform configurations
  • Producing professional OCI diagrams matching Oracle template style

When NOT to use:

  • Non-OCI diagrams (use draw.io manually or other tools)
  • Simple flowcharts or sequence diagrams (use Mermaid or PlantUML)

5-Phase Workflow

Phase 1: Understand the Architecture

Read Terraform configs or documentation to identify:

  • VCNs, subnets, CIDRs
  • Services deployed (compute, databases, LB, functions, etc.)
  • Network topology (DRG, VPN, gateways)
  • Compartment hierarchy

Input sources: VCN.auto.tfvars, DRG.auto.tfvars, main.tf, service .tf files

Phase 2: Plan the Layout

Design the container hierarchy and grid before writing code:

Region
  +-- Hub (left side, narrow)
  |     +-- Firewall / DRG
  +-- VCN (right side, wide)
        +-- Subnet 1 (icons in rows)
        +-- Subnet 2
        +-- Services panel
        +-- Gateways (bottom)

Grid constants (adjust per diagram):

R1 = 50        # first icon row y (below container title)
R2 = 210       # second icon row y
COL = 130      # column gap between icons
SN_H = 380     # subnet height for 2 rows of icons
GAP = 30       # gap between sibling containers
ICON_W = 75    # nominal slot width (actual cell width derived from the SVG's aspect)
ICON_H = 95    # fixed icon cell height

Read the full file on GitHub · 280 lines

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 280 lines · 47 tokens per session scan A 9d8001a68941

Subscribe to this mod's changes

oci-drawio-architect is a skill published in the GitHub repository sergio-farfan/OCI-draw.io-Architect (6 stars, last pushed 2mo ago), licensed MIT. It adds 47 tokens to every session and 3,788 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

aws-architecture-diagram

Generate AWS architecture diagrams in draw.io format. Activates when the user asks to create, generate, or build an architecture diagram, system diagram, or draw.io diagram for AWS services.

vidanov/aws-architecture-diagram-skill · 43 tokens

archify

Create polished, validated architecture, workflow, sequence, data-flow, and lifecycle/state diagrams as explorable standalone HTML with inline SVG, dark/light themes, optional trace motion, and PNG/JPEG/WebP/SVG/WebM export. Accept plain-language requirements or pasted Mermaid flowchart, sequenceDiagram, and…

tt-a1i/archify · 130 tokens

drawio-skill

Create, edit, synchronize, inspect, test, and publish editable draw.io diagrams. Use when the user explicitly requests draw.io/diagrams.net, needs a polished architecture, ERD, UML, sequence, C4, SysML, BPMN, network, swimlane, ML, or infrastructure diagram, wants code/IaC/SQL/OpenAPI/AsyncAPI/Protobuf converted into…

Agents365-ai/drawio-skill · 133 tokens

aws-architecture-diagram

Always use when user asks to create, generate, or build an AWS architecture diagram, cloud infrastructure diagram, or system diagram with AWS services. Also activates for draw.io diagrams mentioning AWS services like Lambda, DynamoDB, S3, API Gateway, etc.

vidanov/aws-architecture-diagram-skill · 57 tokens

aws-architecture-diagram

Generate AWS architecture diagrams in draw.io format. Activates when the user asks to create, generate, or build an architecture diagram, system diagram, or draw.io diagram for AWS services.

vidanov/aws-architecture-diagram-skill · 43 tokens

oci-drawio-icon-native

Build and validate OCI draw.io diagrams in icon-native mode so they never depend on mxgraph.oci. runtime libraries. Use when authoring or fixing Oracle Cloud architecture diagrams in draw.io that must render portably.

frankxai/claude-skills-library · 52 tokens