feat(scripts): skills link/anchor gate and three liveness-exhaustive sections

.changeset/31115-skills-link-and-liveness-gates.md

@@ -0,0 +1,10 @@
+---
+'@objectstack/skills': patch
+---
+
+docs(skills): the operations reference's `os generate <kind>` row names every kind the CLI scaffolds
+
+Clause-②: no
+Metadata-protocol: none
+
+`skills/objectstack-platform/references/operations.md`: the `os generate <kind>` row listed four kinds in prose ("an object / view / flow / skill"); it now lists all ten `GENERATORS` keys (`object` `view` `action` `flow` `dashboard` `app` `skill` `picklist` `permission` `dataset`). The liveness gate now holds that row exhaustive against `GENERATORS` minus `RETIRED_GENERATORS`, so a new generator without a row, or a retired one (`agent`, `schema`) listed again, reds. Two restating clauses in the same file's port table ("so several example apps run side-by-side", "It never silently drifts") were deleted to pay the token ratchet for the longer row.

.github/workflows/lint.yml

@@ -5385,6 +5385,14 @@ jobs:
         continue-on-error: true
         run: pnpm check:skill-top-level-keys
 
+      # Rationale: `scripts/check-skill-links.mjs` header (#31115). Same job, no
+      # paths filter: a section moved between skill files breaks the links INTO
+      # it from files the move never touched.
+      - name: Check every relative link and anchor in the published skills resolves
+        id: check-every-relative-link-and-anchor-in
+        continue-on-error: true
+        run: pnpm check:skill-links
+
       # Rationale: `scripts/check-agent-model-declared.mjs` header (#6803, #6686).
       - name: Check every agent definition declares a model
         id: check-every-agent-definition-declares

package.json

@@ -68,6 +68,7 @@
     "check:skill-frame-freshness": "node scripts/check-skill-frame-freshness.mjs --self-test && node scripts/check-skill-frame-freshness.mjs",
     "check:skill-compatibility": "node scripts/check-skill-compatibility-version.mjs --self-test && node scripts/check-skill-compatibility-version.mjs",
     "check:skill-top-level-keys": "node scripts/check-skill-top-level-keys.mjs --self-test && node scripts/check-skill-top-level-keys.mjs",
+    "check:skill-links": "node scripts/check-skill-links.mjs --self-test && node scripts/check-skill-links.mjs",
     "check:agent-model-declared": "node scripts/check-agent-model-declared.mjs --self-test && node scripts/check-agent-model-declared.mjs",
     "check:agent-test-spelling": "node scripts/check-agent-test-spelling.mjs --self-test && node scripts/check-agent-test-spelling.mjs",
     "check:ratchet-remedy-authority": "node scripts/check-ratchet-remedy-authority.mjs --self-test && node scripts/check-ratchet-remedy-authority.mjs",