onedevatlasBeta
Browse the atlas
AllBTPCAPUI5ABAP
SkillSkilltypeA procedure an agent follows. Indexed here, never written here.See every one →What this type is →independently maintainedindependently maintainedoriginPublished by one person or a small company outside SAP. Says nothing about quality; the readings say that.See every one →

drawio-skill-sap

A GitHub Copilot agent skill that writes BTP solution diagrams as uncompressed draw.io XML against the SAP BTP Solution Diagram Design Guideline, with SAP's own shape library bundled.

Generates .drawio files at one of three levels of detail, L0 for business stakeholders, L1 for architects and L2 for implementation teams, and asks once which is wanted, defaulting to L1. The bundled references/drawio-sap-config.json is the SAP Corporate and SAP BTP shape library exported from draw.io, and hand-written icon styles are refused: every persona and every SAP system, service or product has to render as a real icon or product logo looked up through scripts/sap_shapesearch.py, because mxgraph.sap.icon renders as empty boxes. After generating the XML it exports a draft PNG, checks it against the colour, nesting, overlap and connector rules, edits the XML where the check fails and exports again, with validate.py --strict --score linting the structure deterministically. It creates and validates files without draw.io desktop, which is needed only for PNG, SVG, PDF or JPG export, and the vision self-check is skipped where no vision-capable model is available. Python 3 and its standard library are what the scripts need. Installed by placing the skill folder where a Copilot environment reads Agent Skills, .github/skills/drawio-skill-sap in the repository it is to be used in, or through the skills command line.

GitHub6 ★

Facts

Last pushLicenceMIT

Where it sits

Lives in
BTP/BAIP
Provides
Architecture diagramsBTPArchitecture diagramscapabilityDrawing the architecture and components of a solution so another person can understand their responsibilities and connections. Shared notation makes diagrams readable across teams.Agent guidanceBTPAgent guidancecapabilityPackaged knowledge you hand a coding agent so it gets a framework right unprompted — skills, rule files, instruction packs. Distinct from agent tooling, which is about building agentic features into your application, and from [agent access to your code](capability:agent-code-access), where the agent reads the real project instead of being handed a file about it.
Optional
draw.iodraw.iooutside the atlasProducing an image or PDF export of the generated diagramexport

Who is behind it

lofonDlofonDPersonMaintains this
In the atlas: maintains 1, contributes to 1@lofonDmaintainerLik WeiPersonContributes to this
In the atlas: maintains 1, contributes to 3@likweitan1 contributor

What it declares

Every artifact

Type
Skill
Origin
Independently maintained

As a skill

Distributed through
npmCopied into the project

For agent guidance

Installs into
GitHub Copilot

Tasks this contributes to1Beta

Agent guidance1
Hand an agent SAP's BTP diagram rulesSomeone asks an agent for a BTP solution diagram and wants it drawn in SAP's own visual language without the rules being typed into the prompt.Coversthe rules as a Copilot skill with a seven-step routine
What it does

Written for an Agent Skills location a Copilot environment recognises, and it states the icon rule as a prohibition: every persona and every SAP system, service or product has to render as a real SAP icon or product logo.

Remaining work

Place the skill folder where the Copilot environment reads it, or install it through the skills command line. The vision self-check in its routine is skipped where no vision-capable model is available.

All options on the Agent guidance page →

Connections3

Download
drawio-skill-sap connectionsdrawio-skill-sapPROVIDES→ provides2provides stated Hands an agent a seven-step routine for the diagram: clarify the detail level, check the draw.io CLI, generate the XML from a layout spec, export a draft, self-check it against the design rules, edit, and export again, with the icon lookup script named as the only admissible way to style a shape. lofonD/SAP-BTP-Architecture-Diagram-Generator — skills/drawio-skill-sap/SKILL.md, icon rule: https://github.com/lofonD/SAP-BTP-Architecture-Diagram-Generator/blob/main/skills/drawio-skill-sap/SKILL.md lofonD/SAP-BTP-Architecture-Diagram-Generator — skills/drawio-skill-sap/SKILL.md, compatibility: https://github.com/lofonD/SAP-BTP-Architecture-Diagram-Generator/blob/main/skills/drawio-skill-sap/SKILL.md lofonD/SAP-BTP-Architecture-Diagram-Generator — README: https://github.com/lofonD/SAP-BTP-Architecture-Diagram-GeneratorAgent guidanceprovides stated Writes a BTP solution diagram as editable, uncompressed draw.io XML from a plain-language request, placing official SAP icons from a bundled shape library and keeping the Horizon colours, area nesting and connector semantics the SAP BTP Solution Diagram Design Guideline states. lofonD/SAP-BTP-Architecture-Diagram-Generator — skills/drawio-skill-sap/SKILL.md, frontmatter description: https://github.com/lofonD/SAP-BTP-Architecture-Diagram-Generator/blob/main/skills/drawio-skill-sap/SKILL.md lofonD/SAP-BTP-Architecture-Diagram-Generator — README, What You Get: https://github.com/lofonD/SAP-BTP-Architecture-Diagram-GeneratorArchitecture diagramsNEEDS→ optionally needs1optionally needs stated If: exporting the diagram to PNG, SVG, PDF or JPG Producing an image or PDF export of the generated diagram sap-btp-architecture-diagram-generator README: https://github.com/lofond/sap-btp-architecture-diagram-generatordraw.ioif

Install

npx skills add lofonD/SAP-BTP-Architecture-Diagram-Generator --skill drawio-skill-sap

Copied from lofonD/SAP-BTP-Architecture-Diagram-Generator — README, Quick Start, read . Not run by the atlas.

README

quoted from lofonD/SAP-BTP-Architecture-Diagram-Generator under MIT, read
lofonD/SAP-BTP-Architecture-Diagram-Generator/README.mdOn GitHub

SAP BTP Architecture Diagram Generator

A GitHub Copilot agent skill that generates production-quality SAP Business Technology Platform (BTP) solution diagrams following the official SAP BTP Solution Diagram Design Guideline (Horizon theme).

Skill ID: drawio-skill-sap · Version: 1.0.3 Homepage: lofonD/SAP-BTP-Architecture-Diagram-Generator

What You Get

  • Editable, uncompressed .drawio files
  • Official SAP service icons and product logos from the bundled shape library
  • L0, L1, or L2 diagrams for different audiences
  • Structural validation for IDs, nesting, geometry, and connector routing
  • Optional PNG, SVG, PDF, or JPG exports through the draw.io desktop CLI
  • Optional browser previews through the official @drawio/mcp server

The skill can create and validate .drawio files without draw.io desktop. The desktop app is required only for image or PDF export.

Quick Start

1. Install the skill
Clone

Clone this repository and place skills/drawio-skill-sap in an Agent Skills location recognized by your Copilot environment, such as .github/skills/drawio-skill-sap in the repository where you want to use it.

git clone https://github.com/lofonD/SAP-BTP-Architecture-Diagram-Generator.git
Skills CLI

Install via Skills CLI

npx skills add lofonD/SAP-BTP-Architecture-Diagram-Generator --skill drawio-skill-sap
2. Start using the skill

Open Chat in Agent mode and ask for a diagram:

/drawio-skill-sap Create an L1 BTP diagram for SAP Build Work Zone,
Integration Suite, SAP S/4HANA Cloud, and SAP SuccessFactors.

You can also use a natural-language request:

Create an L2 SAP BTP architecture diagram showing Integration Suite
connecting to SAP S/4HANA Cloud through Cloud Connector, with SAP Cloud
Identity Services handling authentication.

If no level is specified, the skill asks once and defaults to L1.

Diagram generated:

Example SAP BTP architecture diagram

3. Validate the result

Python 3 is required for the bundled scripts; they use only the standard library.

python skills/drawio-skill-sap/scripts/validate.py diagram.drawio --strict --score

Strict validation returns a nonzero exit code for errors or warnings, making it suitable for CI.

4. Export the diagram (optional)

Install draw.io desktop, then export with its CLI:

# Windows: high-DPI PNG with editable diagram XML embedded
& "C:\Program Files\draw.io\draw.io.exe" -x -f png -e -s 2 -o diagram.png diagram.drawio
# macOS / Linux
drawio -x -f png -e -s 2 -o diagram.png diagram.drawio

Use -f svg, -f pdf, or -f jpg for another output format. The -e flag embeds the source diagram in supported exports so it can be reopened in draw.io.

Diagram Levels

LevelAudienceTypical content
L0Business stakeholdersPlatform boundaries, core systems, and simple flows
L1Architects and solution ownersSubaccounts, major services, integrations, and selected semantic flows
L2Implementation teamsRuntimes, services, trust and authentication paths, protocols, and a full legend

Design Rules

The skill applies SAP's atomic design approach rather than treating the diagram as a collection of generic boxes:

  • Named SAP services use official SAP icons or product logos.
  • BTP, subaccount, runtime, and external-system boundaries use nested Horizon areas.
  • Grey is the default connector color; semantic colors are reserved for specific flow meanings.
  • Solid, dashed, and dotted lines distinguish direct, indirect, and optional flows.
  • Structural validation catches broken references, invalid nesting, overlaps, and explicit routing defects.
Horizon palette
PurposeBorder / lineFill
SAP/BTP area#0070F2#EBF8FF
Non-SAP or external area#475E75#F5F6F7
Authentication#188918#F5FAE5
Authorization#5D36FF#F1ECFF
Trust#CB00DC#FFF0FA
Warning#C35500#FFF8D6
Error#D20A0A#FFEAF4
Highlight#07838F#DAFDF5
Connector semantics
StyleMeaning
SolidDirect or synchronous flow
DashedIndirect or asynchronous flow
DottedOptional flow
Thick grey, no arrowFirewall or network barrier

For the complete generation rules, see skills/drawio-skill-sap/SKILL.md.

Included Tools

Run these commands from the repository root.

Find an SAP shape
python skills/drawio-skill-sap/scripts/sap_shapesearch.py "integration suite"
python skills/drawio-skill-sap/scripts/sap_shapesearch.py "cloud identity" --format json
python skills/drawio-skill-sap/scripts/sap_shapesearch.py --list-categories

The search returns exact styles from the bundled SAP shape library. shapesearch.py provides a generic draw.io fallback when no SAP shape matches.

Build from a JSON layout spec

sap_build.py turns a compact JSON specification into uncompressed .drawio XML and resolves SAP icons by name:

python skills/drawio-skill-sap/scripts/sap_build.py spec.json -o diagram.drawio
python skills/drawio-skill-sap/scripts/sap_build.py --find "cloud integration"

See the script's module documentation for the supported node types, edge kinds, and specification format.

Validate a diagram
python skills/drawio-skill-sap/scripts/validate.py diagram.drawio --strict --score
python skills/drawio-skill-sap/scripts/validate.py diagram.drawio --format json
Preview without draw.io desktop

Generate a diagrams.net URL from a local file:

python skills/drawio-skill-sap/scripts/encode_drawio_url.py diagram.drawio

The optional .vscode/mcp.json configuration starts the official draw.io MCP server with npx -y @drawio/mcp. It can open XML in the browser, but SAP shape lookup still belongs to sap_shapesearch.py, and file export still requires draw.io desktop.

Repository Contents

skills/drawio-skill-sap/
|-- SKILL.md                       # Agent instructions and design rules
|-- references/
|   |-- drawio-sap-config.json     # Bundled SAP shape library
|   |-- *.drawio                   # Official reference patterns
|   `-- troubleshooting.md
`-- scripts/
    |-- sap_build.py               # JSON spec to .drawio builder
    |-- sap_shapesearch.py         # SAP shape lookup
    |-- shapesearch.py             # Generic draw.io shape lookup
    |-- validate.py                # Structural linter
    |-- encode_drawio_url.py       # Browser-preview URL generator
    `-- repair_png.py              # Repair truncated PNG IEND chunks

Bundled examples cover SAP Task Center at L0/L1/L2, SAP Start, SAP Build Work Zone, SAP Cloud Identity Services, SAP Private Link Service, and a broader BTP reference architecture.

Troubleshooting

For common XML, icon, layout, routing, and export issues, see skills/drawio-skill-sap/references/troubleshooting.md.

References

License

See LICENSE if present. SAP shape assets are subject to SAP's IP and usage terms.

MIT, read

Others providing24

Architecture diagrams
  1. ARC-DRAWMCP server drawing BTP solution diagrams on a draw.io canvas
  2. btp-solution-diagram-generatorClaude plugin writing BTP solution diagrams as .drawio files
  3. abap-skillsSeventeen agent skills for ABAP development
  4. sap-architectureClaude Code plugin and skill drawing validated BTP diagrams
  5. drawio-btp-diagram-skillsClaude Code skills for BTP architecture diagrams in draw.io
  6. SAP BTP Solution Diagram GuidelinesSAP's visual language and templates for BTP solution diagrams
Agent guidance
  1. sap-cx-developer-companionAgent skill for SAP Customer Experience APIs, CDS and errors
  2. sap-cloud-integration-pipeline-assistantAgent skill for the Pipeline Concept in SAP Cloud Integration
  3. DanKromp/skillOverflowCollection of 41 agent skills, 37 for SAP development tasks
  4. ARC-DRAWMCP server drawing BTP solution diagrams on a draw.io canvas
  5. sap-ai-dev-toolkitMCP proxy pinning an agent's ABAP tools to one SAP system
  6. sap-odata-explorerRust CLI and desktop app for exploring SAP OData services
  7. btp-solution-diagram-generatorClaude plugin writing BTP solution diagrams as .drawio files
  8. abap-skillsSeventeen agent skills for ABAP development
  9. sap-mdk-appsAgent skill for Mobile Development Kit projects
  10. sap-architectureClaude Code plugin and skill drawing validated BTP diagrams
  11. SAP Datasphere Plugin for ClaudeEighteen Datasphere skills over a bundled MCP server
  12. SAP Power for KiroSAP skills for the Kiro IDE
  13. drawio-btp-diagram-skillsClaude Code skills for BTP architecture diagrams in draw.io
  14. aicore-skillsFour agent skills for SAP AI Core in SAP's AI Skills Library
  15. SAP/automation-pilot-agent-skillsEight skills for writing and operating SAP Automation Pilot content
  16. SAP Developers MCPHosted MCP server of developers.sap.com tutorials and missions
  17. sap-fiori-iosAgent skill mapping Fiori iOS UI Kit nodes in Figma to SwiftUI
  18. SAP/leanix-ai-pluginsClaude Code plugin with two skills for SAP LeanIX scripting
  19. SAP-samples/html5-applications-migration-skills-for-sap-btpClaude Code plugin with skills migrating HTML5 apps to appFront
  20. SAP-samples/joule-a2a-agent-toolkitSkills for building an A2A agent for Joule and deploying it to CF
  21. SAP-samples/sap-devs-cliCLI adding SAP developer knowledge and MCP servers to AI coding tools
  22. sap-tutorials-contentAgent skill mapping the developers.sap.com content API
  23. secondsky/sap-skillsForty SAP development plugins for coding agents

Details

Sources3
SAP AI Skills Librarydiscovered here, skills.cloud.sapchecked
github.com/lofonD/SAP-BTP-Architecture-Diagram-Generatortree, pushes, contributors, CIchecked
README.mdquoted, and what the entry declareschecked

Sources are graph entities: the same page may back several entries, and an unreachable source flags every row that rests on it.

Compatibility and provenance
discovered viaSAP AI Skills Library · skills.cloud.sap
first seen in the atlas
ecosystem and domainbtp, developer-experience
Contributors1
Lik Wei

From the repository’s contributor list, .

History in the atlas4
  1. GitHub Copilot
  2. A closing sentence naming where the skill folder goes for Copilot, beside the skills command line already in agent.install.
  3. A repository the SAP AI Skills Library collection cache carries as processedBy baseline-2026-09-18 and that was never drafted into the atlas, so the changed registry record of 2026-10-09 is the first occasion to enter it; first_seen keeps the baseline date and no revises flag applies, since there is no published entry to revise. Written from the repository's README, its LICENSE and the skill's own SKILL.md; hard rule 7: skills are indexed, never authored here. It is a fourth independent BTP diagram skill beside marianfoo-btp-drawio-skill, lemaiwo-btp-drawio-skill and miyasuta-claude-drawio-btp-diagram, and GitHub reports it as not a fork of any of them.
  4. First seen.
For your agent
Ref
artifact:lofond-drawio-skill-sap
JSON
/artifacts/lofond-drawio-skill-sap.json
MCP
Connecting an agent