Restructure to skill-manager conventions

- Move the TypeScript project under scripts/ (src, tsconfig,
  package.json, pnpm lockfile/workspace, canonical .gitignore);
  drop the npm package-lock
- Add scripts/Taskfile.yml aggregator plus .scripts modules
  (loggers, base, cli) with build, run, and validate tasks
- Move the six SKILL-*.md docs into references/ with kebab names
  and extract the connector-routing sections from SKILL.md into
  references/routing-best-practices.md (SKILL.md 666 -> ~310 lines)
- Add license/metadata/compatibility frontmatter, an Available
  scripts section, and update all CLI paths in README and references

skill-manager validate: 13/13 passed, 0 warnings.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

scripts/.scripts/cli/Taskfile.yml

@@ -0,0 +1,32 @@
+# https://taskfile.dev
+
+version: "3"
+
+tasks:
+  build:
+    desc: Compile TypeScript source to dist/
+    cmds:
+      - |
+        ./.scripts/cli/api/build.sh {{ .CLI_ARGS }}
+    silent: true
+
+  run:
+    desc: |
+      Run any drawio-tools action against a .drawio file.
+      Usage: task cli:run -- --file="/path/to/diagram.drawio" --action=<action> [--page <index>]
+      Actions: summary, page-summary, page-hierarchy, page-connectors-summary, page-connectors-validation,
+      page-labels-validation, page-shape-bbox-validation, page-orphans, page-recommendations,
+      page-hierarchy-full, page-negative-space-summary, validate
+    cmds:
+      - |
+        ./.scripts/cli/api/run.sh {{ .CLI_ARGS }}
+    silent: true
+
+  validate:
+    desc: |
+      Validate a .drawio file (XML well-formedness + required structure).
+      Usage: task cli:validate -- --file="/path/to/diagram.drawio"
+    cmds:
+      - |
+        ./.scripts/cli/api/validate.sh {{ .CLI_ARGS }}
+    silent: true

scripts/.scripts/cli/api/build.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+# -------------------------------------------------------------------------------------
+#
+#
+#
+# -------------------------------------------------------------------------------------
+set -e
+
+. ./.scripts/cli/lib/--index.sh
+
+_cli__build "$@"

scripts/.scripts/cli/api/run.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+# -------------------------------------------------------------------------------------
+#
+#
+#
+# -------------------------------------------------------------------------------------
+set -e
+
+. ./.scripts/cli/lib/--index.sh
+
+_cli__run "$@"

scripts/.scripts/cli/api/validate.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+# -------------------------------------------------------------------------------------
+#
+#
+#
+# -------------------------------------------------------------------------------------
+set -e
+
+. ./.scripts/cli/lib/--index.sh
+
+_cli__validate "$@"

scripts/.scripts/cli/lib/--env-vars-reader.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# -------------------------------------------------------------------------------------
+#
+#
+#
+# -------------------------------------------------------------------------------------
+
+ALL_ARGS=("$@")
+while [[ "$#" -gt 0 ]]; do
+	case $1 in
+	*) ;;
+	esac
+	shift
+done
+set -- "${ALL_ARGS[@]}"

scripts/.scripts/cli/lib/--env-vars-validator.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+# -------------------------------------------------------------------------------------
+#
+#
+#
+# -------------------------------------------------------------------------------------
+
+. ./.scripts/cli/lib/--index-api.sh
+
+# No required environment variables for cli module

scripts/.scripts/cli/lib/--index-api.sh

@@ -0,0 +1,12 @@
+#!/bin/bash
+# -------------------------------------------------------------------------------------
+#
+#
+#
+# -------------------------------------------------------------------------------------
+
+. ./.scripts/cli/lib/-build.sh
+
+. ./.scripts/cli/lib/-run.sh
+
+. ./.scripts/cli/lib/-validate.sh

scripts/.scripts/cli/lib/--index.sh

@@ -0,0 +1,21 @@
+#!/bin/bash
+# -------------------------------------------------------------------------------------
+#
+#
+#
+# -------------------------------------------------------------------------------------
+. ./.scripts/loggers/lib/--index.sh
+. ./.scripts/base/lib/--index.sh
+#
+#       --> passed parameters are read & exported environment variables
+#
+. ./.scripts/cli/lib/--env-vars-reader.sh
+#
+#       --> required environment variables are validated for existence
+#
+. ./.scripts/cli/lib/--env-vars-validator.sh
+#
+#       --> available functions are imported/exported
+#
+. ./.scripts/cli/lib/--index-api.sh
+# -------------------------------------------------------------------------------------

scripts/.scripts/cli/lib/-build.sh

@@ -0,0 +1,12 @@
+#!/bin/bash
+# -------------------------------------------------------------------------------------
+#
+#
+#
+# -------------------------------------------------------------------------------------
+
+_cli__build() {
+  local FUNCTION_NAME="_cli__build"
+  _loggers_info "${FUNCTION_NAME}" "Compiling TypeScript source to dist/"
+  pnpm run build
+}

scripts/.scripts/cli/lib/-run.sh

@@ -0,0 +1,12 @@
+#!/bin/bash
+# -------------------------------------------------------------------------------------
+#
+#
+#
+# -------------------------------------------------------------------------------------
+
+_cli__run() {
+  local FUNCTION_NAME="_cli__run"
+  _loggers_info "${FUNCTION_NAME}" "Running drawio-tools CLI"
+  node dist/cli/commands.js "$@"
+}

scripts/.scripts/cli/lib/-validate.sh

@@ -0,0 +1,12 @@
+#!/bin/bash
+# -------------------------------------------------------------------------------------
+#
+#
+#
+# -------------------------------------------------------------------------------------
+
+_cli__validate() {
+  local FUNCTION_NAME="_cli__validate"
+  _loggers_info "${FUNCTION_NAME}" "Validating .drawio file via drawio-tools CLI"
+  node dist/cli/commands.js --action validate "$@"
+}