What problem does it solve? Bitbucket Cloud does not render ```mermaid fenced blocks in Markdown, so diagrams show as raw source code. Worse, naively converting with mmdc produces SVGs whose labels vanish in Bitbucket because Mermaid's default <foreignObject> labels are not painted inside <img> tags. This Skill pre-renders diagrams to Bitbucket-safe SVGs, rewrites Markdown to reference them, and verifies them in CI. ## Core Features & Use Cases - Bitbucket-safe rendering: Renders .mmd/.mermaid files and fenced blocks in Markdown to SVG with htmlLabels: false, an opaque white background, and an Atlassian-tuned palette, then hard-fails if any <foreignObject> survives. - Markdown rewriting with sidecar sources: Extracts fenced blocks to sidecar .mmd files under docs/diagrams/ and replaces them with image links, idempotently. - CI verification: A --check mode compares source and SVG content hashes from a .mermaid-svg.json manifest, distinguishing STALE, DAMAGED, and UNVERIFIED states, with a ready-made Bitbucket Pipelines snippet. - Use Case: Migrating docs from GitHub to Bitbucket and finding every architecture diagram renders as raw code — run the script, commit the SVGs and manifest, and add the verify step to pull-request builds. ## Quick Start Ask the AI to convert all Mermaid diagrams in this repository to Bitbucket-compatible SVGs and set up a Pipelines check that fails when they go stale.
