diff --git a/.claude/skills/java-tdd-guide/SKILL.pointer.md b/.claude/skills/java-tdd-guide/SKILL.pointer.md
new file mode 100644
index 0000000..b74e8e2
--- /dev/null
+++ b/.claude/skills/java-tdd-guide/SKILL.pointer.md
@@ -0,0 +1,20 @@
+---
+name: java-tdd-guide-pointer
+description: Marker file — the canonical Java TDD skill lives in the sibling workspace repo at .claude/skills/java-tdd-guide/SKILL.md and must be in the Claude session scope for the harness to load it.
+---
+
+# Pointer — Java TDD Guide
+
+The canonical skill content lives in the `workspace` sibling repo:
+
+`../../../../workspace/.claude/skills/java-tdd-guide/SKILL.md`
+
+For Claude sessions opened against this repo to find the skill, the
+`workspace` repo must also be in the session's repository scope. The
+standard remote-execution setup adds it automatically.
+
+If a session reports the skill as missing, verify the session scope
+includes `bernardladenthin/workspace` and retry.
+
+This file exists so human readers and any future drift-detection tooling
+can see the dependency from this repo to the canonical skill.
diff --git a/.github/shared-files.sha256 b/.github/shared-files.sha256
index c4da82c..48f053a 100644
--- a/.github/shared-files.sha256
+++ b/.github/shared-files.sha256
@@ -37,6 +37,7 @@ ab45f5c102b47dd16c325d4d9c283d158ba90c05f484eac45b2767885c4462f9  .github/signin
 0f08122e597f93dbbdc9c80e88984b4bf4738951d5902813df3d4640cdb11bac  .github/ISSUE_TEMPLATE/feature_request.md
 ebfcc0adf59f5858bbe4dc077c906304a197f72a55256f0d5aac669bee5e871f  .github/PULL_REQUEST_TEMPLATE.md
 f2a516d98a4287486dac82fc2c1293d81e3a4a1087e3ace934da0af5caaeace5  CODE_OF_CONDUCT.md
+b191c691d333249de1780e474817446cd94262e0bfa87e27cb6e412865f90943  .claude/skills/java-tdd-guide/SKILL.pointer.md
 074e6e32c86a4c0ef8b3ed25b721ca23aca83df277cd88106ef7177c354615ff  LICENSES/Apache-2.0.txt
 b05785f9f18e6716bab63424b11454513b9943a222595b70411009202fc592b5  LICENSES/MIT.txt
 edc34bc287c32b4d7ff970c0dd7a25e7d724cdd2775ef2b65aaccccd49c733c8  .editorconfig