@lovehlmmm/primekit 1.0.0

package/skills/diagram/references/snapshot-hashes.yaml

@@ -0,0 +1,73 @@
+# ak:diagram golden PNG hashes — regenerate via snapshot_test.py --update-goldens
+architecture/dark: d6fda461e6de5ee1ab66406e4439168ab360234eb6c090ac85650b16226a1544
+architecture/full: e3279f8ef5f36d9ac592a4482cf8142e62e9252bfde5c894e9af3df479df3cfa
+architecture/light: dd8b8d74d5ea0910793cdbec04acd270838a0a66952387e931f077ade2b90d98
+bar/dark: 5c4be33f5e409f4455dc7b71a4ad98d2746b85f3c2c4cd4afe3f8c6685517ae3
+bar/full: 8a3fa79859977f1bb6975b0c59fd971294930ca37ba4d4dfefc249f772ce3363
+bar/light: 3d7dc136ab2561be7f3c42866c4be4b1037ad0f0a8aa7f7547309f550b5d2dc4
+data-flow/dark: 00c33d10eb6b71ed0445cb6689f47dc35ce4af3cae14cd566d5330e4e3ae6745
+data-flow/full: 2c43e2ab9e17030f8437efa80ccda644a98b39bcdd98dfefd353f533007bd286
+data-flow/light: c028d703c2d349d352c3433de8777220282b0ecb0c64f44273f31d9758027838
+dp-integration/dark: 849078d6b1e94ea79ddcb9775f7b93812255c0cd62a1eff5c2a74cddd71ca8ce
+dp-integration/full: 8484e293147e0ae8148bf2304117158bc861ac70a6ca9ce9ba45e4a82648ac1a
+dp-integration/light: ca8e6df21e36b075c500bfe6d8a3e4da6df2ea25a2dddee7bf3f39a92de639f3
+dp-security-matrix/dark: ede74a63929e4e16e6916ed5d06d7f76eda046c09d75ac61a2847f1454766067
+dp-security-matrix/full: f79d27a4acc49c690f41a54d3faf17c8b298cbd0d7fbeb1e5317294bda17de89
+dp-security-matrix/light: c140341dba992c5e28bfb15af64f1d3bc5f091e8435167d7b7a9135dfd5a1aab
+flowchart/dark: 1cb61ff734c3bdc65eb2b6bc11a1e0e29538b0fd50da8215ddeafb747881ed0b
+flowchart/full: 89b32cc318c9fce647394fca5291908d12d3dc0b69f01df8e2ce131f9ecfe827
+flowchart/light: cccce369742c522da00dd326458c38d3a508dad3ae8ab4e8c8bb1796b626f208
+gantt/dark: 042520da5446c3ac32b5fead98014ab6c1ba514e2f7561417de3ea97ddecd622
+gantt/full: f6a7b6cb6a0d217f983e1b420cf214f4bc524a10192b79fd4f1704c508ba40c5
+gantt/light: bf69413814c73e6208d8be21b03aeedd3cc300fcded3ce1159976e92cce303b6
+high-level/dark: f3a2775ad99ba61df932f73497c347819e9bf7a35d145d9b0c22359f154874c9
+high-level/full: fbe3e86473c38c0c3c9a90d5d40387fb6e5efc68e1fbab14e141a22dba07c115
+high-level/light: 94a9754686f2de821dd0e80b63652eb3374963435fe288f68ba717114bf42bbe
+it-state/dark: f169d92a549d6b8a5f6b29693ba0283d36838e934bdfa07a2edfa54a024ce900
+it-state/full: 5337989eaef4dc69fe7b6b07cb4f175a9321bc8ce673ed6ae884c8c78663a62d
+it-state/light: d5dea8618b7baa1bd6a84d28ebc7cb6f20e3904218202cba7875bf0706fb7d1c
+layers/dark: aeed2e55313d8e4dd31d2add449c7c4a88547c81a586ba4a83236e194e096330
+layers/full: e2809480fb11ea4d0c755d8a69ca267655a5daa1911312bc60163027d585fdcb
+layers/light: a4117a8c17769a82ffc953503c3ee2eee5809892aa9ce7d4c4cf7c3edee829cd
+line/dark: 73f7332cffd8b20c45a88614b618b27e77bb179d29022345efc9a09c4f2a66e9
+line/full: 1d0cd42416491a9b1ff2ac9e8c42d068f283081527987a7413a4c24ba57880b4
+line/light: 43318cc64bf59d0c9196c46735f6806affb81414f2392aa52e23cf446df01dc1
+loop/dark: caf0e2a4f2af772b6a0cc78a0612ed5b031efa87ef665e89b24b50ca96b60175
+loop/full: 1ef7d34a0cdea5dde0edbef4b957f97c0cc4938b6f6c386de128bc78982d7822
+loop/light: 8306f5e5a12c0c5ef9a1ad7655b54e84dfea487bba61ec734bb3e525a146e897
+medallion/dark: 9189f604bccccfd1c34abb8e0e4448c6c98b8b6ffaeaf356342a8ee87d639404
+medallion/full: 5a6cab16495724a3904dab3933ee1cd5483de3c9d9a9191c614be4230336cc08
+medallion/light: d493954bdc2694b2ca23372a3273ff6ebc955d1456cfdeeddb5ab3c44bb5793e
+nested/dark: 0ab7215be37a4268953ffe4a9da0407eb14c4b5d9c621d09b98ad49f538fcb0d
+nested/full: a76fad1cc0fee174e7c073b50f77246e311e548573cca52dc9fefc6c504c1b63
+nested/light: 811463a22b483493f1e691d5127e9ce18285ea2773f0f29782feff5fadaab238
+org-chart/dark: e551a152a65ddcc2f97c2f7b1cc685b8fb1048827d0f9b50b9439c290597d4fc
+org-chart/full: 8d606a06fcf70a824e1d2541707b964c4c2831268d6afec8ded38ecd4b4a769f
+org-chart/light: ee270831e5b87249677e9cb72ab35d60cfd3bdb2d4c16963f1023f95fa804b6c
+process/dark: 5708173c30a411d8d166c8f0787bd56bb3d7f0894265bb0206feab822721f801
+process/full: 37eceb26bdc795b805597384d74d8e45cf3ffa5f4a60fb56d79fb2aba023cc2e
+process/light: aeb5cd16531b5292d02c6449c2fa2f9e844afb407e757bea60c27f4626a0242b
+pyramid/dark: dae6dfded8b490fba9c5e0354709fa1576221b9831f89e1f30ca53115e618fe0
+pyramid/full: bff0fa5e4a93ad5ccda15b5b1d5d85012acba1c1e74cf5182643b43db84eb5d0
+pyramid/light: 3dffb9dc1a04253c71cfb3e9524d61c1e03a9339698ea06e01d034be4a4de372
+quadrant/dark: b32b0c0dd3720703d498715d7543a16bda44bfcf3c01b2af18b10b618a050b1f
+quadrant/full: 2ae33c3f6cf54dcec56c13cd20c30d17f96954163df737e6241dd515d9400554
+quadrant/light: ab13e1ea96959a327bd5c6633d10179ffa4302ff6813e1db382677739a76d47d
+radar/dark: 8fcacae95de05fd3919fde45130fb59fdc35f7d3f9ed3ebc3c8d84f4497333f4
+radar/full: feec7502fdbe1ff2c6c8e2125ad32b1c9bb6e4bd5a4338a7a2b9cf88034bcee2
+radar/light: 8b7c263fe44a94043933ca399fc68d9abc8cca2da7d6ca2a20d4d063c580c3d6
+scatter/dark: 412be7cdd5c03b8fad74868f8b13b7263d3af1d273121b534dfabbf121648e7c
+scatter/full: 3b7eb35864d2cd8cb3baa5172117acbeb882eeb7f5ff88d66815080ab0a881d7
+scatter/light: 76c791242e4261810fd65f5d45ca967cdfff4c88e69dbe7dd08bedbbb5137c14
+sequence/dark: acdc41adbdc8cc60ef2fcf1c1b578ff7c84c933d98ad319c969e35fd1f45bd44
+sequence/full: b8efc3c168f8a1ac77ee4f6ab830f7e5938e8ea25b1702d330505345f4759224
+sequence/light: 003fb5890c0977c281915e3d38c0a4bb4a43a3a87060f2db1c37254eb2dc2d4a
+state/dark: 97bcc5f4d7eedbd5a8f812d84464565f20b41c16e98ba5abebbf21a8e9fc650f
+state/full: 1a478b8e950148506db193ba017f1d430a7e37620851efb98954d5a63ab6633d
+state/light: 79008e0a5351cd45432fe91cfc12e320e7537cc068ba4889af98ed4e2d87501e
+swimlane/dark: 2308e04db14d451dc8cae23729a6e31e53088519ecd0f046d46a92a2e6a26c89
+swimlane/full: ae9bfa29aba2e9c27d71377486a81ae115cfd76652b4861e3697b3d64c050784
+swimlane/light: e54d469360b701e7e059d7ef8bd4397306becef78c7ca9b8563730de6b793b63
+timeline/dark: 2565ae83434815987f6f281c3ae9407a689c119174328f368984655d49263824
+timeline/full: b7184946deb106cc1d1ffd2ce7070573e475e6f904116961e55954972cb8bcd2
+timeline/light: 69cc6367225e34c0336a6ccc3e4c92887f562c3b64f08c68703391ea5cdba3ff

package/skills/diagram/references/snapshot-requirements.txt

@@ -0,0 +1,2 @@
+playwright==1.62.0
+pyyaml==6.0.3

package/skills/diagram/references/vendoring-metadata.yaml

@@ -0,0 +1,379 @@
+# ak:diagram vendoring metadata — do not edit by hand.
+# Regenerated by scripts/vendor_from_upstream.py.
+upstream_repo: cathrynlavery/diagram-design
+upstream_license: MIT
+upstream_sha: 09df49d8d1a1c7fb2efdfcdc7a2a0713534350a6
+vendored_at: 2026-08-16T07:31:38.966805+00:00
+template_count: 72
+
+# Additional MIT vendors not managed by vendor_from_upstream.py:
+extra_vendors:
+  - asset: assets/mermaid.min.js
+    upstream: github.com/mermaid-js/mermaid
+    license: MIT
+    version: "11.4.1"
+    source_url: https://cdn.jsdelivr.net/npm/mermaid@11.4.1/dist/mermaid.min.js
+    sha256_12: a43bc1afd446
+    vendored_at: 2026-08-16T07:00:00+00:00
+
+templates:
+  - type: architecture
+    variant: light
+    source: example-architecture.html
+    target: assets/templates/architecture/light.html
+    sha256_12: cc0f1d8723bc
+  - type: architecture
+    variant: dark
+    source: example-architecture-dark.html
+    target: assets/templates/architecture/dark.html
+    sha256_12: ff11cd2cb102
+  - type: architecture
+    variant: full
+    source: example-architecture-full.html
+    target: assets/templates/architecture/full.html
+    sha256_12: 725e3592aec0
+  - type: high-level
+    variant: light
+    source: example-high-level.html
+    target: assets/templates/high-level/light.html
+    sha256_12: 091e1de3f90a
+  - type: high-level
+    variant: dark
+    source: example-high-level-dark.html
+    target: assets/templates/high-level/dark.html
+    sha256_12: d46f162e19d0
+  - type: high-level
+    variant: full
+    source: example-high-level-full.html
+    target: assets/templates/high-level/full.html
+    sha256_12: 27b7fae4a278
+  - type: layers
+    variant: light
+    source: example-layers.html
+    target: assets/templates/layers/light.html
+    sha256_12: 59fb40103f0c
+  - type: layers
+    variant: dark
+    source: example-layers-dark.html
+    target: assets/templates/layers/dark.html
+    sha256_12: 14e824c4180b
+  - type: layers
+    variant: full
+    source: example-layers-full.html
+    target: assets/templates/layers/full.html
+    sha256_12: 5e4304570ddb
+  - type: medallion
+    variant: light
+    source: example-medallion.html
+    target: assets/templates/medallion/light.html
+    sha256_12: 77fa038825a7
+  - type: medallion
+    variant: dark
+    source: example-medallion-dark.html
+    target: assets/templates/medallion/dark.html
+    sha256_12: e2eeec29d234
+  - type: medallion
+    variant: full
+    source: example-medallion-full.html
+    target: assets/templates/medallion/full.html
+    sha256_12: f20250c70eb7
+  - type: dp-integration
+    variant: light
+    source: example-dp-integration.html
+    target: assets/templates/dp-integration/light.html
+    sha256_12: dd065862bb11
+  - type: dp-integration
+    variant: dark
+    source: example-dp-integration-dark.html
+    target: assets/templates/dp-integration/dark.html
+    sha256_12: c99b26bf4605
+  - type: dp-integration
+    variant: full
+    source: example-dp-integration-full.html
+    target: assets/templates/dp-integration/full.html
+    sha256_12: 4899f32b2a16
+  - type: dp-security-matrix
+    variant: light
+    source: example-dp-security-matrix.html
+    target: assets/templates/dp-security-matrix/light.html
+    sha256_12: ca5016543dd5
+  - type: dp-security-matrix
+    variant: dark
+    source: example-dp-security-matrix-dark.html
+    target: assets/templates/dp-security-matrix/dark.html
+    sha256_12: 7d3241c91973
+  - type: dp-security-matrix
+    variant: full
+    source: example-dp-security-matrix-full.html
+    target: assets/templates/dp-security-matrix/full.html
+    sha256_12: 04a55f186e5e
+  - type: data-flow
+    variant: light
+    source: example-data-flow.html
+    target: assets/templates/data-flow/light.html
+    sha256_12: c006ee2978f4
+  - type: data-flow
+    variant: dark
+    source: example-data-flow-dark.html
+    target: assets/templates/data-flow/dark.html
+    sha256_12: 323a6f1cf655
+  - type: data-flow
+    variant: full
+    source: example-data-flow-full.html
+    target: assets/templates/data-flow/full.html
+    sha256_12: 975a698ca0f3
+  - type: flowchart
+    variant: light
+    source: example-flowchart.html
+    target: assets/templates/flowchart/light.html
+    sha256_12: ecbc7ba68f27
+  - type: flowchart
+    variant: dark
+    source: example-flowchart-dark.html
+    target: assets/templates/flowchart/dark.html
+    sha256_12: 6a79b7826141
+  - type: flowchart
+    variant: full
+    source: example-flowchart-full.html
+    target: assets/templates/flowchart/full.html
+    sha256_12: ead68eabd793
+  - type: sequence
+    variant: light
+    source: example-sequence.html
+    target: assets/templates/sequence/light.html
+    sha256_12: c75134546fe2
+  - type: sequence
+    variant: dark
+    source: example-sequence-dark.html
+    target: assets/templates/sequence/dark.html
+    sha256_12: 213c3f562816
+  - type: sequence
+    variant: full
+    source: example-sequence-full.html
+    target: assets/templates/sequence/full.html
+    sha256_12: af6da031dd33
+  - type: state
+    variant: light
+    source: example-state.html
+    target: assets/templates/state/light.html
+    sha256_12: 2f09bf92a400
+  - type: state
+    variant: dark
+    source: example-state-dark.html
+    target: assets/templates/state/dark.html
+    sha256_12: 7c7a3d282856
+  - type: state
+    variant: full
+    source: example-state-full.html
+    target: assets/templates/state/full.html
+    sha256_12: 639ab9d931a6
+  - type: swimlane
+    variant: light
+    source: example-swimlane.html
+    target: assets/templates/swimlane/light.html
+    sha256_12: 89cfe6e28d41
+  - type: swimlane
+    variant: dark
+    source: example-swimlane-dark.html
+    target: assets/templates/swimlane/dark.html
+    sha256_12: 62fb48585f9d
+  - type: swimlane
+    variant: full
+    source: example-swimlane-full.html
+    target: assets/templates/swimlane/full.html
+    sha256_12: b20e79d6b1dc
+  - type: process
+    variant: light
+    source: example-process.html
+    target: assets/templates/process/light.html
+    sha256_12: ed63f5fe5a66
+  - type: process
+    variant: dark
+    source: example-process-dark.html
+    target: assets/templates/process/dark.html
+    sha256_12: 3044545489db
+  - type: process
+    variant: full
+    source: example-process-full.html
+    target: assets/templates/process/full.html
+    sha256_12: a349323b1f1e
+  - type: org-chart
+    variant: light
+    source: example-org-chart.html
+    target: assets/templates/org-chart/light.html
+    sha256_12: 3a894d84b0c8
+  - type: org-chart
+    variant: dark
+    source: example-org-chart-dark.html
+    target: assets/templates/org-chart/dark.html
+    sha256_12: 57340cbc0be9
+  - type: org-chart
+    variant: full
+    source: example-org-chart-full.html
+    target: assets/templates/org-chart/full.html
+    sha256_12: e725d835be36
+  - type: loop
+    variant: light
+    source: example-loop.html
+    target: assets/templates/loop/light.html
+    sha256_12: d503659273fb
+  - type: loop
+    variant: dark
+    source: example-loop-dark.html
+    target: assets/templates/loop/dark.html
+    sha256_12: fb012568edf9
+  - type: loop
+    variant: full
+    source: example-loop-full.html
+    target: assets/templates/loop/full.html
+    sha256_12: 8152798cbde9
+  - type: pyramid
+    variant: light
+    source: example-pyramid.html
+    target: assets/templates/pyramid/light.html
+    sha256_12: 879d4634c80d
+  - type: pyramid
+    variant: dark
+    source: example-pyramid-dark.html
+    target: assets/templates/pyramid/dark.html
+    sha256_12: f605592e5e2d
+  - type: pyramid
+    variant: full
+    source: example-pyramid-full.html
+    target: assets/templates/pyramid/full.html
+    sha256_12: c0aaa5d37fe5
+  - type: quadrant
+    variant: light
+    source: example-quadrant.html
+    target: assets/templates/quadrant/light.html
+    sha256_12: 28b36edcfb76
+  - type: quadrant
+    variant: dark
+    source: example-quadrant-dark.html
+    target: assets/templates/quadrant/dark.html
+    sha256_12: 6b9f5e8a8703
+  - type: quadrant
+    variant: full
+    source: example-quadrant-full.html
+    target: assets/templates/quadrant/full.html
+    sha256_12: 27a606e4cbea
+  - type: radar
+    variant: light
+    source: example-radar.html
+    target: assets/templates/radar/light.html
+    sha256_12: 6e20707c6e9e
+  - type: radar
+    variant: dark
+    source: example-radar-dark.html
+    target: assets/templates/radar/dark.html
+    sha256_12: a43e86265976
+  - type: radar
+    variant: full
+    source: example-radar-full.html
+    target: assets/templates/radar/full.html
+    sha256_12: 6e0a0b6e337b
+  - type: timeline
+    variant: light
+    source: example-timeline.html
+    target: assets/templates/timeline/light.html
+    sha256_12: 83f9c2b14435
+  - type: timeline
+    variant: dark
+    source: example-timeline-dark.html
+    target: assets/templates/timeline/dark.html
+    sha256_12: 78162f40c913
+  - type: timeline
+    variant: full
+    source: example-timeline-full.html
+    target: assets/templates/timeline/full.html
+    sha256_12: dfc25755fd2b
+  - type: nested
+    variant: light
+    source: example-nested.html
+    target: assets/templates/nested/light.html
+    sha256_12: 4eb009134912
+  - type: nested
+    variant: dark
+    source: example-nested-dark.html
+    target: assets/templates/nested/dark.html
+    sha256_12: 47389cb89bb7
+  - type: nested
+    variant: full
+    source: example-nested-full.html
+    target: assets/templates/nested/full.html
+    sha256_12: 6c9c27c40a34
+  - type: it-state
+    variant: light
+    source: example-it-state.html
+    target: assets/templates/it-state/light.html
+    sha256_12: b6af6e0b4e1b
+  - type: it-state
+    variant: dark
+    source: example-it-state-dark.html
+    target: assets/templates/it-state/dark.html
+    sha256_12: c46b38acec6c
+  - type: it-state
+    variant: full
+    source: example-it-state-full.html
+    target: assets/templates/it-state/full.html
+    sha256_12: a8c848609803
+  - type: bar
+    variant: light
+    source: example-bar.html
+    target: assets/templates/bar/light.html
+    sha256_12: dfad9117267e
+  - type: bar
+    variant: dark
+    source: example-bar-dark.html
+    target: assets/templates/bar/dark.html
+    sha256_12: 7c528113245d
+  - type: bar
+    variant: full
+    source: example-bar-full.html
+    target: assets/templates/bar/full.html
+    sha256_12: 45d3faa7eaef
+  - type: line
+    variant: light
+    source: example-line.html
+    target: assets/templates/line/light.html
+    sha256_12: 6d2c6868e8cb
+  - type: line
+    variant: dark
+    source: example-line-dark.html
+    target: assets/templates/line/dark.html
+    sha256_12: 8e9339a0e9e1
+  - type: line
+    variant: full
+    source: example-line-full.html
+    target: assets/templates/line/full.html
+    sha256_12: 88f82b205e5e
+  - type: scatter
+    variant: light
+    source: example-scatter.html
+    target: assets/templates/scatter/light.html
+    sha256_12: a79949fc877f
+  - type: scatter
+    variant: dark
+    source: example-scatter-dark.html
+    target: assets/templates/scatter/dark.html
+    sha256_12: c5bbd029a413
+  - type: scatter
+    variant: full
+    source: example-scatter-full.html
+    target: assets/templates/scatter/full.html
+    sha256_12: 3c008fe57201
+  - type: gantt
+    variant: light
+    source: example-gantt.html
+    target: assets/templates/gantt/light.html
+    sha256_12: a848b29821db
+  - type: gantt
+    variant: dark
+    source: example-gantt-dark.html
+    target: assets/templates/gantt/dark.html
+    sha256_12: 3ec81f25b7c1
+  - type: gantt
+    variant: full
+    source: example-gantt-full.html
+    target: assets/templates/gantt/full.html
+    sha256_12: c4233e930f9e

package/skills/diagram/scripts/doctor.py

@@ -0,0 +1,153 @@
+#!/usr/bin/env python3
+"""ak:diagram doctor — probe required tools, report only, never install.
+
+Exit codes:
+    0 — all required deps present, skill ready.
+    1 — one or more required deps missing; message tells the user what to install.
+
+Usage:
+    python3 scripts/doctor.py            # human-readable report
+    python3 scripts/doctor.py --json     # machine-readable JSON report
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+SKILL_ROOT = Path(__file__).resolve().parent.parent
+MERMAID_JS = SKILL_ROOT / "assets" / "mermaid.min.js"
+PW_BROWSERS_HINT = "PLAYWRIGHT_BROWSERS_PATH"
+
+
+def _shared_venv_python() -> Path | None:
+    """Locate the shared skill venv python — walk up looking for .claude/skills/.venv."""
+    # From kits/<name>/skills/ak-diagram/scripts → project root is 5 parents up
+    for candidate in [SKILL_ROOT.parents[i] for i in range(2, 6) if i < len(SKILL_ROOT.parents)]:
+        py = candidate / ".claude" / "skills" / ".venv" / "bin" / "python3"
+        if py.exists():
+            return py
+        py_win = candidate / ".claude" / "skills" / ".venv" / "Scripts" / "python.exe"
+        if py_win.exists():
+            return py_win
+    env_hint = os.environ.get("AGENTKIT_HOME")
+    if env_hint:
+        py = Path(env_hint) / ".claude" / "skills" / ".venv" / "bin" / "python3"
+        if py.exists():
+            return py
+    return None
+
+
+def _which(binary: str) -> str | None:
+    return shutil.which(binary)
+
+
+def _probe_playwright() -> tuple[bool, str]:
+    """Detect whether Playwright + Chromium is usable via the shared skill venv."""
+    venv_python = _shared_venv_python()
+    py = str(venv_python) if venv_python else sys.executable
+    try:
+        proc = subprocess.run(
+            [py, "-c", "import playwright.sync_api as _; print('ok')"],
+            capture_output=True,
+            timeout=10,
+            text=True,
+        )
+        if proc.returncode == 0 and "ok" in proc.stdout:
+            return True, f"playwright present via {py}"
+        return False, f"playwright missing: {proc.stderr.strip() or 'import failed'}"
+    except (subprocess.TimeoutExpired, OSError) as exc:
+        return False, f"playwright probe failed: {exc}"
+
+
+def _probe_chromium() -> tuple[bool, str]:
+    root = os.environ.get(PW_BROWSERS_HINT, "/opt/pw-browsers")
+    candidates = [
+        Path(root) / "chromium",
+        Path(root) / "chromium_headless_shell-1194",
+        Path(root) / "chromium-1194",
+    ]
+    hits = [str(c) for c in candidates if c.exists()]
+    if hits:
+        return True, f"chromium found: {hits[0]}"
+    return False, f"chromium not found under {root} (set {PW_BROWSERS_HINT})"
+
+
+def _probe_ffmpeg() -> tuple[bool, str]:
+    ffmpeg = _which("ffmpeg")
+    if ffmpeg:
+        return True, f"ffmpeg on PATH: {ffmpeg}"
+    root = os.environ.get(PW_BROWSERS_HINT, "/opt/pw-browsers")
+    candidates = list(Path(root).glob("ffmpeg*"))
+    if candidates:
+        return True, f"ffmpeg bundled: {candidates[0]}"
+    return False, "ffmpeg missing (needed only for --video output)"
+
+
+def _probe_mermaid() -> tuple[bool, str]:
+    if MERMAID_JS.exists():
+        size_kb = MERMAID_JS.stat().st_size // 1024
+        return True, f"mermaid.min.js vendored ({size_kb} KB)"
+    return False, f"mermaid.min.js missing at {MERMAID_JS} — run scripts/vendor_from_upstream.py"
+
+
+def _probe_mmdc() -> tuple[bool, str]:
+    mmdc = _which("mmdc")
+    if mmdc:
+        return True, f"mmdc on PATH: {mmdc} (fast-path enabled)"
+    return True, "mmdc absent — fine, HTML pipeline used instead"
+
+
+def run_probes() -> dict:
+    probes = {
+        "playwright": _probe_playwright(),
+        "chromium": _probe_chromium(),
+        "ffmpeg": _probe_ffmpeg(),
+        "mermaid_js": _probe_mermaid(),
+        "mmdc": _probe_mmdc(),
+    }
+    required = ("playwright", "chromium", "mermaid_js")
+    report = {
+        name: {"ok": ok, "detail": detail}
+        for name, (ok, detail) in probes.items()
+    }
+    report["_required_missing"] = [n for n in required if not probes[n][0]]
+    report["_ready"] = not report["_required_missing"]
+    return report
+
+
+def _print_human(report: dict) -> None:
+    print("ak:diagram — dependency report")
+    print("-" * 40)
+    for name, entry in report.items():
+        if name.startswith("_"):
+            continue
+        mark = "OK " if entry["ok"] else "!! "
+        print(f"{mark} {name:12s} {entry['detail']}")
+    print("-" * 40)
+    if report["_ready"]:
+        print("READY — skill has everything it needs.")
+    else:
+        print("MISSING — install the required deps above then re-run.")
+        print("Doctor never installs anything on your behalf.")
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="ak:diagram dep probe")
+    parser.add_argument("--json", action="store_true", help="emit JSON")
+    args = parser.parse_args()
+    report = run_probes()
+    if args.json:
+        print(json.dumps(report, indent=2))
+    else:
+        _print_human(report)
+    return 0 if report["_ready"] else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())