{"ref":"artifact:marianfoo-btp-drawio-skill","page":"/artifacts/marianfoo-btp-drawio-skill","json":"/artifacts/marianfoo-btp-drawio-skill.json","generated":"2026-10-26","drafted_with_ai":true,"entity":{"id":"marianfoo-btp-drawio-skill","name":"sap-architecture","artifact_type":"skill","ecosystem":"btp","domain":"developer-experience","origin_ring":"independent","description":{"one_line":"A Claude Code plugin and portable agent skill that turns a plain-English description into a BTP diagram in [SAP Architecture Center](actor:sap-architecture-center) style, checked by a validator before it is handed over.","short":"Claude Code plugin and skill drawing validated BTP diagrams","what_it_solves":"The skill carries the style rules a generic draw.io skill lacks, without which the output comes out with the wrong palette, bent arrows and clipped labels. It bundles 100 BTP service icons in the variant the [SAP BTP Solution Diagram Guidelines](artifact:sap-btp-solution-diagrams) mandate, and 71 reference templates from those guidelines, the [SAP Architecture Center](actor:sap-architecture-center) and other SAP references, which keep SAP's Apache-2.0 licence. A validator checks each diagram and an autofixer repairs what it finds. The rest is Markdown and dependency-free Python under MIT, so agents other than Claude can run it: the README names the instruction file to point at the skill for Codex, GitHub Copilot, Cursor and the tools that read AGENTS.md, and states that on those the skill is wired in per project rather than loaded automatically.","when_not_to_use":"A diagram of anything other than an SAP, BTP or on-premise landscape: the skill is tuned to the Horizon style and its 71 templates. It drafts rather than finishes, and its README budgets 15 to 30 minutes of edits in draw.io per diagram. Without Python the validator does not run."},"links":{"repo":"https://github.com/marianfoo/btp-drawio-skill"},"type_properties":{"distribution":{"value":["agent-plugin","copy"],"sources":[{"url":"https://github.com/marianfoo/btp-drawio-skill","title":"sap-architecture — README","checked":"2026-10-18","quote":"/plugin install sap-architecture"},{"url":"https://github.com/marianfoo/btp-drawio-skill","title":"sap-architecture — README","checked":"2026-10-18","quote":"git clone https://github.com/marianfoo/btp-drawio-skill.git"}]}},"identity":{"author":"Marian Zeis","license":"MIT"},"skills":{"provenance":"indexed","kind":"capability","canonical_source":"https://github.com/marianfoo/btp-drawio-skill"},"provides":[{"capability":"capability:agent-guidance","what_it_does":"A skill in the open Agent Skills format, installable as a Claude Code plugin or wired into another agent's instructions, carrying the icons, the templates and the scripts locally so nothing is fetched while it works.","facets":[{"key":"installs_into","value":["Claude Code","Claude Desktop","Codex","GitHub Copilot","Cursor","Gemini CLI"],"source":{"url":"https://github.com/marianfoo/btp-drawio-skill","title":"marianfoo/btp-drawio-skill — README, Other AI coding tools","checked":"2026-10-15","quote":"The skill is **portable** — plain Markdown (`SKILL.md`) plus dependency-free Python scripts — so any agent that can read a project instructions file and run shell commands can drive it."},"sources":[{"url":"https://github.com/marianfoo/btp-drawio-skill","title":"marianfoo/btp-drawio-skill — README, What you need","checked":"2026-10-15","quote":"- **Claude Code or Claude Desktop / Claude.ai** — any recent version with skills support."},{"url":"https://github.com/marianfoo/btp-drawio-skill","title":"marianfoo/btp-drawio-skill — README, instruction-file table","checked":"2026-10-15","quote":"| **OpenAI Codex** (CLI & IDE) | `AGENTS.md` in your repo root |"},{"url":"https://github.com/marianfoo/btp-drawio-skill","title":"marianfoo/btp-drawio-skill — README, instruction-file table","checked":"2026-10-15","quote":"| **GitHub Copilot** (VS Code, agent mode) | `.github/copilot-instructions.md` |"},{"url":"https://github.com/marianfoo/btp-drawio-skill","title":"marianfoo/btp-drawio-skill — README, instruction-file table","checked":"2026-10-15","quote":"| **Cursor** | bundled [`cursor-rules/sap-architecture.mdc`](plugins/sap-architecture/cursor-rules/sap-architecture.mdc) → `.cursor/rules/` |"},{"url":"https://github.com/marianfoo/btp-drawio-skill","title":"marianfoo/btp-drawio-skill — README, instruction-file table","checked":"2026-10-15","quote":"| **Gemini CLI · Jules · Amp · Factory** | `AGENTS.md` (same open standard) |"}]}],"sources":[{"url":"https://github.com/marianfoo/btp-drawio-skill","title":"marianfoo/btp-drawio-skill — README","checked":"2026-09-13","quote":"A Claude Code plugin (and Agent-Skill-compatible standalone skill)"},{"url":"https://github.com/marianfoo/btp-drawio-skill","title":"marianfoo/btp-drawio-skill — README, What you need","checked":"2026-10-15","quote":"- **No API keys, no `npm install`, no MCP server, no cloud calls** — every icon, template, and script is bundled and runs locally."},{"url":"https://github.com/marianfoo/btp-drawio-skill","title":"marianfoo/btp-drawio-skill — README, Other AI coding tools, caveats","checked":"2026-10-15","quote":"unlike Claude, these tools won't *auto-load* the skill — the instruction file wires it in per project; and the agent needs shell access plus **Python 3.8+** to run the scripts."}]},{"capability":"capability:architecture-diagrams","what_it_does":"Generates editable .drawio solution diagrams and checks them against the guidelines before handing them over.","facets":[{"key":"diagram_format","value":["drawio"],"source":{"url":"https://raw.githubusercontent.com/marianfoo/btp-drawio-skill/main/README.md","title":"marianfoo/btp-drawio-skill — README","checked":"2026-09-28","quote":"A Claude Code plugin (and Agent-Skill-compatible standalone skill) that turns a plain-English description into a polished **SAP Architecture Center / BTP solution diagram** as an editable `.drawio` file"}},{"key":"checks_the_file","value":true,"source":{"url":"https://raw.githubusercontent.com/marianfoo/btp-drawio-skill/main/README.md","title":"marianfoo/btp-drawio-skill — README, What's bundled","checked":"2026-09-28","quote":"**A validator + autofixer** (`validate.py`, `autofix.py`) that catch and mechanically repair bent arrows, clipped labels, off-palette colors, off-grid coordinates, wrong stroke widths, non-Helvetica fonts, and more"}},{"key":"repairs_findings","value":true,"source":{"url":"https://raw.githubusercontent.com/marianfoo/btp-drawio-skill/main/README.md","title":"marianfoo/btp-drawio-skill — README, What's bundled","checked":"2026-09-28","quote":"**A validator + autofixer** (`validate.py`, `autofix.py`) that catch and mechanically repair bent arrows, clipped labels, off-palette colors, off-grid coordinates, wrong stroke widths, non-Helvetica fonts, and more"}},{"key":"checks_the_picture","value":true,"source":{"url":"https://raw.githubusercontent.com/marianfoo/btp-drawio-skill/main/README.md","title":"marianfoo/btp-drawio-skill — README, Nudge it to a good diagram","checked":"2026-09-28","quote":"The skill ships a feedback loop that closes the gap — when you ask Claude to keep improving, it renders the diagram to an image, scores it against the SAP corpus, *looks at the picture*, fixes one thing, and re-checks."}}],"sources":[{"url":"https://github.com/marianfoo/btp-drawio-skill","title":"marianfoo/btp-drawio-skill — README","checked":"2026-09-13","quote":"gates every output behind a validator"}]}],"lineage":[{"target":"artifact:miyasuta-claude-drawio-btp-diagram","kind":"inspired-by","source":{"url":"https://github.com/marianfoo/btp-drawio-skill","title":"marianfoo/btp-drawio-skill — README, credits","checked":"2026-09-13","quote":"the center-alignment rule for straight orthogonal edges; the `docs/rules + docs/styles + docs/GUIDELINES.md` layering pattern"}},{"target":"artifact:lemaiwo-btp-drawio-skill","kind":"inspired-by","source":{"url":"https://github.com/marianfoo/btp-drawio-skill","title":"marianfoo/btp-drawio-skill — README, credits","checked":"2026-09-13","quote":"the marketplace + single-plugin repo layout used here; the approach of bundling SAP icon XML libraries directly"}}],"maintainers":["actor:marianfoo"],"requires":[{"ref":"external:drawio","for":"Viewing and editing the result only; the skill writes the .drawio file without it.","sources":[{"url":"https://github.com/marianfoo/btp-drawio-skill","title":"marianfoo/btp-drawio-skill — README","checked":"2026-09-13","quote":"Only needed to view/edit; the skill writes the `.drawio` without it."}]}],"provenance":{"discovered_via":[{"source":"source:curator"}],"first_seen":"2026-09-13"},"drafted_with_ai":true,"contributors":["actor:marianfoo"],"history":[{"date":"2026-10-15","field":"provides.agent-guidance.facets.installs_into","from":null,"to":"Claude Code, Claude Desktop, Codex, GitHub Copilot, Cursor, Gemini CLI","reason":"capability:agent-guidance declared the installs_into property on the BTP door. The README states the skill is portable and then names the instruction file for each tool in a table, so the statement is the portability sentence and each value carries the row that names it. The table also names Jules, Amp and Factory, which are outside the property's values and are left for the curation queue rather than entered as written."},{"date":"2026-10-15","field":"description.what_it_solves","from":"The rest is Markdown and dependency-free Python under MIT, so agents other than Claude can run it.","to":"The same, with the instruction file the README names per tool and its statement that on those tools the skill is wired in per project rather than loaded automatically.","reason":"The entry said other agents can run it and not what that costs. The README's own caveat, read on 2026-10-15, is that the auto-load is Claude's alone, which is the difference between this option and a Claude-only one."}]},"effective_normative_relations":[],"readings":{"liveness":[{"label":"Maintenance","tier":"unknown","evidence":"no release data"},{"label":"Continuity","tier":"fair","evidence":"one contributor, personally owned"},{"label":"Repository","tier":"good","evidence":"pushed 2026-06, 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":"good","evidence":"Test green, 2026-06-25"}],"practice":[{"label":"Tests","tier":"good","evidence":"4 test files"},{"label":"Docs","tier":"good","evidence":"docs/ with 1 page, README 19 KB"},{"label":"Changelog","tier":"fair","evidence":"none in the repo"}],"reach":[{"value":null,"unit":"installs/week"},{"value":28,"unit":"watching"}]},"signals":{"crawled_at":"2026-10-26","npm":"not published under this name","stars":28,"forks":5,"open_issues":1,"archived":false,"pushed_at":"2026-06-25","license_spdx":null,"org_owned":false,"default_branch":"main","contributors":1,"tree_truncated":false,"test_files":4,"workflows":1,"other_ci":false,"readme_bytes":19277,"docs_files":1,"changelog":false,"license_file":true,"dts_files":0,"ci_status":"success","ci_run_at":"2026-06-25","ci_workflow":"Test","ci_event":"push","readme_path":"README.md","readme_sha":"f2975f08197336783a7ea0ec4e730acb1282a563","first_commit":"2026-04-22","last_commit":"2026-06-25","commits":42,"created_at":"2026-04-22T07:28:43Z","open_prs":1,"repo_read":"2026-10-26"},"release_notes":{"license":"MIT","quotable":true,"source":{"kind":"github-releases","url":"https://github.com/marianfoo/btp-drawio-skill/releases"},"format":"github-releases","releases":[{"version":"0.2.0","date":"2026-04-28","date_source":"github","heading":"v0.2.0 — 27 SAP references + comparison harness","url":"https://github.com/marianfoo/btp-drawio-skill/releases/tag/v0.2.0","sections":[],"hash":"3af2a0c555471912"}],"crawled_at":"2026-10-25"},"edges":{"maintainers":[{"ref":"actor:marianfoo","name":"Marian Zeis","json":"/actors/marianfoo.json"}],"contributors":[{"ref":"actor:marianfoo","name":"Marian Zeis","json":"/actors/marianfoo.json"}],"explained_by":[{"ref":"content:creating-an-arc-1-btp-diagram-with-codex-and-a-drawio-skill","name":"Creating an ARC-1 BTP Diagram with Codex and a draw.io Skill","json":"/content/creating-an-arc-1-btp-diagram-with-codex-and-a-drawio-skill.json"}],"alternative_to_this":[],"needed_by":[],"available_via":[],"parts":[],"add_ons":[],"answered_through_parts":[]}}