From cfc9c1bcb5d881af08be27396a56e59f826ddf6c Mon Sep 17 00:00:00 2001 From: jarvis-at-skic Date: Thu, 3 Sep 2026 20:57:00 +0000 Subject: [PATCH] [verified] refactor: reference diagrams-drawio --- SKILL.md | 4 ++-- references/drawio-source-diagrams.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/SKILL.md b/SKILL.md index 80a6cf2..9732db9 100644 --- a/SKILL.md +++ b/SKILL.md @@ -16,7 +16,7 @@ metadata: framework: Diátaxis hermes: tags: [docusaurus, documentation, diataxis, drawio, mdx, react-flow, gitea, ci-cd, pages] - related_skills: [drawio-main, gitea-repository-operations] + related_skills: [diagrams-drawio, gitea-repository-operations] compatibility: Designed for Docusaurus v3. Works with Cline, Claude Code, GitHub Copilot, OpenAI Codex, and other compatible agent environments --- @@ -169,7 +169,7 @@ Use `@xyflow/react` when validated documentation data needs an interactive roadm ### Draw.io source diagrams -When a page needs a Draw.io diagram, keep the editable `.drawio` XML in the documentation repository and render that source directly with `docusaurus-plugin-drawio`. Load `drawio-main` to author or change the diagram, then follow [references/drawio-source-diagrams.md](references/drawio-source-diagrams.md) to install the plugin with pnpm, register it, consume the source from MDX with `@theme/Drawio` and `!!raw-loader!`, select multi-page diagrams, and verify the production build and browser rendering. An exported PNG/SVG alone is not an onboarded source diagram. +When a page needs a Draw.io diagram, keep the editable `.drawio` XML in the documentation repository and render that source directly with `docusaurus-plugin-drawio`. Load `diagrams-drawio` to author or change the diagram, then follow [references/drawio-source-diagrams.md](references/drawio-source-diagrams.md) to install the plugin with pnpm, register it, consume the source from MDX with `@theme/Drawio` and `!!raw-loader!`, select multi-page diagrams, and verify the production build and browser rendering. An exported PNG/SVG alone is not an onboarded source diagram. ### Interactive Elements (Use Sparingly) diff --git a/references/drawio-source-diagrams.md b/references/drawio-source-diagrams.md index 24cbe3a..cef9bad 100644 --- a/references/drawio-source-diagrams.md +++ b/references/drawio-source-diagrams.md @@ -7,7 +7,7 @@ Use this workflow when a Docusaurus v3 site must render an editable Draw.io sour - Commit the editable `.drawio` XML in the documentation repository. - Render that source directly in MDX; do not make a PNG/SVG export the only authoritative artifact. - Keep the source adjacent to, or in a clearly named diagram directory near, the page that consumes it. -- Use the global `drawio-main` skill to author and validate diagram content. +- Use the global `diagrams-drawio` skill to author and validate diagram content. - Use this `documentation-docusaurus` skill to onboard and render the source in Docusaurus. Recommended layout: -- 2.54.0