{"ref":"artifact:lofond-drawio-skill-sap","page":"/artifacts/lofond-drawio-skill-sap","json":"/artifacts/lofond-drawio-skill-sap.json","generated":"2026-10-26","drafted_with_ai":true,"entity":{"id":"lofond-drawio-skill-sap","name":"drawio-skill-sap","artifact_type":"skill","ecosystem":"btp","domain":"developer-experience","origin_ring":"independent","description":{"one_line":"A GitHub Copilot agent skill that writes BTP solution diagrams as uncompressed [draw.io](external:drawio) XML against the [SAP BTP Solution Diagram Design Guideline](artifact:sap-btp-solution-diagrams), with SAP's own shape library bundled.","short":"GitHub Copilot skill writing BTP solution diagrams as draw.io XML","what_it_solves":"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."},"links":{"repo":"https://github.com/lofonD/SAP-BTP-Architecture-Diagram-Generator"},"type_properties":{"distribution":{"value":["npm","copy"],"sources":[{"url":"https://github.com/lofonD/SAP-BTP-Architecture-Diagram-Generator","title":"drawio-skill-sap — README","checked":"2026-10-18","quote":"npx skills add lofonD/SAP-BTP-Architecture-Diagram-Generator --skill drawio-skill-sap"},{"url":"https://github.com/lofonD/SAP-BTP-Architecture-Diagram-Generator","title":"drawio-skill-sap — README","checked":"2026-10-18","quote":"Clone this repository and place `skills/drawio-skill-sap` in an Agent Skills location recognized by your Copilot environment"}]}},"identity":{"author":"lofonD","license":"MIT"},"agent":{"source":{"url":"https://github.com/lofonD/SAP-BTP-Architecture-Diagram-Generator","title":"lofonD/SAP-BTP-Architecture-Diagram-Generator — README, Quick Start","checked":"2026-10-09","quote":"npx skills add lofonD/SAP-BTP-Architecture-Diagram-Generator --skill drawio-skill-sap"},"install":"npx skills add lofonD/SAP-BTP-Architecture-Diagram-Generator --skill drawio-skill-sap"},"skills":{"provenance":"indexed","kind":"capability","canonical_source":"https://github.com/lofonD/SAP-BTP-Architecture-Diagram-Generator/tree/main/skills/drawio-skill-sap"},"provides":[{"capability":"capability:architecture-diagrams","what_it_does":"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.","sources":[{"url":"https://github.com/lofonD/SAP-BTP-Architecture-Diagram-Generator/blob/main/skills/drawio-skill-sap/SKILL.md","title":"lofonD/SAP-BTP-Architecture-Diagram-Generator — skills/drawio-skill-sap/SKILL.md, frontmatter description","checked":"2026-10-09","quote":"Generate SAP BTP solution diagrams as .drawio XML aligned to the SAP BTP Solution Diagram Design Guideline (Horizon theme), including official colors, area nesting, connector semantics, and draw.io CLI export support."},{"url":"https://github.com/lofonD/SAP-BTP-Architecture-Diagram-Generator","title":"lofonD/SAP-BTP-Architecture-Diagram-Generator — README, What You Get","checked":"2026-10-09","quote":"The skill can create and validate `.drawio` files without draw.io desktop. The desktop app is required only for image or PDF export."}]},{"capability":"capability:agent-guidance","what_it_does":"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.","facets":[{"key":"installs_into","value":["GitHub Copilot"],"source":{"url":"https://github.com/lofonD/SAP-BTP-Architecture-Diagram-Generator","title":"lofonD/SAP-BTP-Architecture-Diagram-Generator — README, Quick Start, Clone","checked":"2026-10-15","quote":"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."}}],"sources":[{"url":"https://github.com/lofonD/SAP-BTP-Architecture-Diagram-Generator/blob/main/skills/drawio-skill-sap/SKILL.md","title":"lofonD/SAP-BTP-Architecture-Diagram-Generator — skills/drawio-skill-sap/SKILL.md, icon rule","checked":"2026-10-09","quote":"Every persona and every SAP system/service/product in a diagram MUST render as a real SAP icon or product logo"},{"url":"https://github.com/lofonD/SAP-BTP-Architecture-Diagram-Generator/blob/main/skills/drawio-skill-sap/SKILL.md","title":"lofonD/SAP-BTP-Architecture-Diagram-Generator — skills/drawio-skill-sap/SKILL.md, compatibility","checked":"2026-10-09","quote":"The vision self-check is skipped if there is no vision-capable model available."},{"url":"https://github.com/lofonD/SAP-BTP-Architecture-Diagram-Generator","title":"lofonD/SAP-BTP-Architecture-Diagram-Generator — README","checked":"2026-10-15","quote":"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)."}]}],"provenance":{"discovered_via":[{"source":"source:sap-ai-skills-library","channel":"skills.cloud.sap"}],"first_seen":"2026-09-18"},"history":[{"date":"2026-10-09","field":"entry","from":null,"to":"created","reason":"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."},{"date":"2026-10-15","field":"provides.agent-guidance.facets.installs_into","from":null,"to":"GitHub Copilot","reason":"capability:agent-guidance declared the installs_into property on the BTP door. The README's own first sentence calls it a GitHub Copilot agent skill and its install step places the folder where a Copilot environment reads Agent Skills. It also offers the skills command line, which names no host of its own, so Copilot is the one value the documentation states."},{"date":"2026-10-15","field":"description.what_it_solves","from":null,"to":"A closing sentence naming where the skill folder goes for Copilot, beside the skills command line already in agent.install.","reason":"The entry carried the one-line install command and not the path the README's own first option uses, which is what a reader on Copilot needs."}],"drafted_with_ai":true,"requires":[{"ref":"external:drawio","for":"Producing an image or PDF export of the generated diagram","requirement":"conditional","condition":"exporting the diagram to PNG, SVG, PDF or JPG","basis":"binding","role":"export","sources":[{"url":"https://github.com/lofond/sap-btp-architecture-diagram-generator","title":"sap-btp-architecture-diagram-generator README","checked":"2026-10-18","quote":"The desktop app is required only for image or PDF export."}]}],"maintainers":["actor:lofond"],"contributors":["actor:likweitan","actor:lofond"]},"effective_normative_relations":[],"readings":{"liveness":[{"label":"Maintenance","tier":"unknown","evidence":"no release data"},{"label":"Continuity","tier":"fair","evidence":"2 contributors"},{"label":"Repository","tier":"good","evidence":"pushed 2026-09, not archived"}],"compatibility":[{"label":"Declared for","tier":"unknown","evidence":"no BTP release lines in the atlas"},{"label":"Survived majors","tier":"unknown","evidence":"no BTP release lines in the atlas"},{"label":"Maintainer's CI","tier":"fair","evidence":"no CI configured"}],"practice":[{"label":"Tests","tier":"poor","evidence":"none found in the tree"},{"label":"Docs","tier":"good","evidence":"README 8 KB"},{"label":"Changelog","tier":"fair","evidence":"none in the repo"}],"reach":[{"value":null,"unit":"installs/week"},{"value":6,"unit":"watching"}]},"signals":{"crawled_at":"2026-10-26","npm":"not published under this name","stars":6,"forks":1,"open_issues":0,"archived":false,"pushed_at":"2026-09-25","license_spdx":"MIT","org_owned":false,"default_branch":"main","created_at":"2026-08-04T06:33:44Z","open_prs":0,"tree_truncated":false,"test_files":0,"workflows":0,"other_ci":false,"readme_bytes":8099,"docs_files":0,"changelog":false,"license_file":true,"dts_files":0,"first_commit":"2026-08-04","last_commit":"2026-09-25","commits":19,"contributors":2,"readme_path":"README.md","readme_sha":"5c2ef528b933151e8daa6ceae222c9b5d6f63426","repo_read":"2026-10-26"},"edges":{"maintainers":[{"ref":"actor:lofond","name":"lofonD","json":"/actors/lofond.json"}],"contributors":[{"ref":"actor:likweitan","name":"Lik Wei","json":"/actors/likweitan.json"},{"ref":"actor:lofond","name":"lofonD","json":"/actors/lofond.json"}],"explained_by":[],"alternative_to_this":[],"needed_by":[],"available_via":[],"parts":[],"add_ons":[],"answered_through_parts":[]}}