{"ref":"artifact:miyasuta-claude-drawio-btp-diagram","page":"/artifacts/miyasuta-claude-drawio-btp-diagram","json":"/artifacts/miyasuta-claude-drawio-btp-diagram.json","generated":"2026-11-15","drafted_with_ai":true,"entity":{"id":"miyasuta-claude-drawio-btp-diagram","name":"drawio-btp-diagram-skills","artifact_type":"skill","ecosystem":"btp","domain":"developer-experience","origin_ring":"independent","description":{"one_line":"Two Claude Code skills that take a BTP architecture described in words through a Mermaid sketch to draw.io XML, with a structural and a visual review after the drawing.","short":"Claude Code skills for BTP architecture diagrams in draw.io","what_it_solves":"Two skills split the work: `drawio-sap-diagrams` runs the chain from words to a Mermaid sketch to draw.io XML, and `sap-diagram-review` checks what came out. The Mermaid step comes first because draw.io XML is verbose and hard for a person to read back. The XML is then written in three passes: a coordinate-free inventory of cells, positions as formulas over main-axis variables, then the px values, so a correction changes a formula instead of a column of numbers. `references/guidelines.md` is the maintainer's English summary of the [SAP BTP Solution Diagram Guidelines](artifact:sap-btp-solution-diagrams) and is named the source of truth above the style files that implement them. Two steps stay the person's: pasting the XML into draw.io by hand, and placing the Generic Icons, whose base64 SVG the skill keeps out of Claude's output to hold token use down.","when_not_to_use":"The README tells you to fork before cloning, because Claude rewrites `references/` and `SKILL.md` in place as you use it, so a clone shared between people changes under all of them. Installing means `git` and `ln` on macOS or Linux and a symlink into `~/.claude/skills`. Fine positioning stays manual: the coordinates Claude writes can be rough apart from the centre coordinates of elements joined by a straight arrow and the containment relationships.","to_build_on_it":"The references are written to grow by use: a style the shipped files do not yet define, or a house rule of your own, is persisted to `references/elements.md`, `references/layout.md` or the Conventions section of `SKILL.md` when you mention it in conversation, inside your own fork. An optional Stop hook in `~/.claude/settings.json` commits whatever a session changed in the skill repository. `sap-diagram-review` carries its own triggers, so it can be called from another workflow on its own."},"links":{"repo":"https://github.com/miyasuta/drawio-btp-diagram-skills"},"provides":[{"capability":"capability:agent-guidance","what_it_does":"Two skill files with their own triggers, plus reference documents Claude is told to read at named steps of a diagramming session, and a rule for writing new conventions back into those files.","facets":[{"key":"installs_into","value":["Claude Code","Claude Desktop"],"source":{"url":"https://github.com/miyasuta/drawio-btp-diagram-skills","title":"miyasuta/drawio-btp-diagram-skills — README","checked":"2026-10-23","quote":"A Skill bundle for Claude Code / Claude Desktop. It provides a collaborative workflow that **turns a design you describe in words into an architecture diagram drawn in draw.io**."},"sources":[{"url":"https://github.com/miyasuta/drawio-btp-diagram-skills","title":"miyasuta/drawio-btp-diagram-skills — README, Prerequisites","checked":"2026-10-23","quote":"- Claude Code installed"}]}],"sources":[{"url":"https://raw.githubusercontent.com/miyasuta/drawio-btp-diagram-skills/main/skills/drawio-sap-diagrams/SKILL.md","title":"drawio-btp-diagram-skills — skills/drawio-sap-diagrams/SKILL.md, References","checked":"2026-10-23","quote":"| This SKILL.md (Conventions section) | Design conventions (composition patterns, labels, language) | **Steps 2-3** (Mermaid) |"},{"url":"https://raw.githubusercontent.com/miyasuta/drawio-btp-diagram-skills/main/skills/drawio-sap-diagrams/SKILL.md","title":"drawio-btp-diagram-skills — skills/drawio-sap-diagrams/SKILL.md, When You Encounter an Unfamiliar Style or Icon","checked":"2026-10-23","quote":"If you encounter an element not defined in `references/` (an unregistered `SAPIcon` name, a new kind of rectangle, a color/line type used for the first time, etc.), **don't guess — check with the user**."}]},{"capability":"capability:architecture-diagrams","what_it_does":"Turns a described BTP landscape into draw.io XML by way of Mermaid, then reviews the XML it wrote and the screenshot the person pastes back, and regenerates the coordinates when a review finds something.","facets":[{"key":"diagram_format","value":["drawio"],"source":{"url":"https://github.com/miyasuta/drawio-btp-diagram-skills","title":"miyasuta/drawio-btp-diagram-skills — README","checked":"2026-10-23","quote":"A Skill bundle for Claude Code / Claude Desktop. It provides a collaborative workflow that **turns a design you describe in words into an architecture diagram drawn in draw.io**."}},{"key":"checks_the_file","value":true,"source":{"url":"https://raw.githubusercontent.com/miyasuta/drawio-btp-diagram-skills/main/skills/sap-diagram-review/SKILL.md","title":"drawio-btp-diagram-skills — skills/sap-diagram-review/SKILL.md, Overview","checked":"2026-10-23","quote":"1. **Structural review (Step 4.5)**: runs automatically right after XML generation. Checks structure and style against the documentation"}},{"key":"checks_the_picture","value":true,"source":{"url":"https://raw.githubusercontent.com/miyasuta/drawio-btp-diagram-skills/main/skills/sap-diagram-review/SKILL.md","title":"drawio-btp-diagram-skills — skills/sap-diagram-review/SKILL.md, Overview","checked":"2026-10-23","quote":"2. **Visual review (Step 5.5)**: after the human pastes it into draw.io, checks the appearance via a screenshot"}},{"key":"repairs_findings","value":true,"source":{"url":"https://raw.githubusercontent.com/miyasuta/drawio-btp-diagram-skills/main/skills/drawio-sap-diagrams/SKILL.md","title":"drawio-btp-diagram-skills — skills/drawio-sap-diagrams/SKILL.md, Workflow","checked":"2026-10-23","quote":"**Fix-loop rule**: if a problem is found at step 5 / 5.5, do **not** Edit ad hoc — always **go back to 4b-1 (logical coordinate pass)**. First sort out what changes (main-axis variables / relative formulas), then recompute the values at 4b-2, and re-run Step 4.5. This prevents partial fixes from breaking overall consistency."}}],"sources":[{"url":"https://github.com/miyasuta/drawio-btp-diagram-skills","title":"miyasuta/drawio-btp-diagram-skills — README, Overview / What It Does","checked":"2026-10-23","quote":"4. A **structural review** (checking the XML) and a **visual review** (checking a screenshot) run automatically"},{"url":"https://github.com/miyasuta/drawio-btp-diagram-skills","title":"miyasuta/drawio-btp-diagram-skills — README, Overview / What It Does","checked":"2026-10-23","quote":"Reading draw.io XML directly is hard to review, so the key idea is to nail down the logic in Mermaid first, then translate it into XML."}]}],"requires":[{"ref":"external:drawio","for":"The person pastes the generated XML into draw.io by hand and attaches a screenshot, which the visual review then reads.","requirement":"required","basis":"binding","sources":[{"url":"https://raw.githubusercontent.com/miyasuta/drawio-btp-diagram-skills/main/skills/drawio-sap-diagrams/SKILL.md","title":"drawio-btp-diagram-skills — skills/drawio-sap-diagrams/SKILL.md, Overview","checked":"2026-10-23","quote":"- **XML is pasted by hand**: applying it to draw.io is done by the human, via copy-paste. This is faster than drawing directly through a tool."},{"url":"https://github.com/miyasuta/drawio-btp-diagram-skills","title":"miyasuta/drawio-btp-diagram-skills — README, Draw Your First Diagram","checked":"2026-10-23","quote":"Paste the XML into draw.io, attach a screenshot to the conversation, and the visual review will run automatically too."}]}],"maintainers":["actor:mio-yasutake"],"provenance":{"discovered_via":[{"source":"source:github"}],"first_seen":"2026-09-13"},"drafted_with_ai":true,"contributors":["actor:mio-yasutake"]},"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-10, 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 9 KB"},{"label":"Changelog","tier":"fair","evidence":"none in the repo"}],"reach":[{"value":null,"unit":"installs/week"},{"value":4,"unit":"watching"}]},"signals":{"crawled_at":"2026-11-14","npm":"not published under this name","stars":4,"forks":1,"open_issues":0,"archived":false,"pushed_at":"2026-10-22","license_spdx":"MIT","org_owned":false,"default_branch":"main","contributors":1,"tree_truncated":false,"test_files":0,"workflows":0,"other_ci":false,"readme_bytes":9102,"docs_files":0,"changelog":false,"license_file":true,"dts_files":0,"first_commit":"2026-04-23","last_commit":"2026-10-22","commits":35,"readme_path":"README.md","readme_sha":"5ff77231ca53afbbb3804b538b419e915280d763","created_at":"2026-04-26T10:52:54Z","open_prs":0,"repo_read":"2026-11-14"},"edges":{"maintainers":[{"ref":"actor:mio-yasutake","name":"Mio Yasutake","json":"/actors/mio-yasutake.json"}],"contributors":[{"ref":"actor:mio-yasutake","name":"Mio Yasutake","json":"/actors/mio-yasutake.json"}],"explained_by":[],"alternative_to_this":[],"needed_by":[],"available_via":[],"parts":[],"add_ons":[],"answered_through_parts":[]}}