@cleocode/skills 2026.10.9 → 2026.10.10-canary.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/skills",
-  "version": "2026.10.9",
+  "version": "2026.10.10-canary.2",
   "description": "CLEO skill definitions - bundled with CLEO monorepo",
   "main": "index.js",
   "types": "index.d.ts",

package/skills/ct-dev-workflow/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: ct-dev-workflow
 description: Development workflow orchestration for task-driven development with atomic commits, conventional commit messages, and systematic release processes. Enforces task traceability, branch discipline, smart test scope selection, and GitHub Actions integration. Use when committing code, creating releases, managing branches, or following contribution protocols. Triggers on commit operations, release preparation, or workflow compliance needs.
-version: 3.1.16
+version: 3.1.18
 protocol: contribution
 dependencies: []
 sharedResources:
@@ -14,7 +14,7 @@ compatibility:
   - gemini-cli
 license: MIT
 metadata:
-  version: 3.1.16
+  version: 3.1.18
   tier: core
   install: harness
   covers:
@@ -26,7 +26,7 @@ metadata:
     - packages/core/src/hooks.ts
     - packages/core/templates/git-hooks/**
     - packages/contracts/src/git-hooks.ts
-  lastReviewed: 2026-10-11
+  lastReviewed: 2026-10-12
   stability: stable
 ---
 
@@ -101,6 +101,10 @@ reviewing the tracked destination; this opt-in still preserves foreign and
 customized hooks. Init warnings carry the exact opt-in command.
 
 The pre-push wrapper spools Git stdin once for task IDs and shared project checks.
+Besides Merge/Revert/fixup!/squash!/amend!, commit-msg and pre-push accept the exact
+subject `initial: cleo init` (the empty commit `cleo init` makes so HEAD resolves; T13577);
+any longer or different subject still needs a task ID. A template change adds the
+previously shipped hash to `legacy-hashes.json` so installed copies refresh.
 It probes CLEO_PROJECT_HOOK_V1 before invoking the implemented CLI adapter;
 missing or incompatible runners warn and allow. Verify nested checkout paths, linked
 worktrees, custom hook paths, historical release bodies and corrupt receipts
@@ -508,7 +512,9 @@ are delivery outputs. Until the hooks-v1 stable promotion, a stable build is ine
 `cleo hook sync --activate` refuses with `E_HOOKS_V1_UNRELEASED`, existing receipts report
 `unreleased` and never run (a required `--ci` check fails), and `--disable` still works; a
 `-canary.N` build or the promotion's `cleo.releasedFeatures` stamp opens the gate
-(`core/src/hooks/release-gate.ts`). Preview with `cleo hook sync --dry-run`; explicit local activation
+(`core/src/hooks/release-gate.ts`). A source checkout carries a stable version, so hooks
+cannot be activated on main either; only code passing the gate's `allowUnreleased` option
+(tests) opts in. Preview with `cleo hook sync --dry-run`; explicit local activation
 uses `cleo hook sync --activate` and binds definitions, handlers and dependencies to
 current hashes. Source drift requires reactivation. Agent project checks are advisory;
 Git applies project verdicts. Native harness trust remains separately unverified.

package/skills/ct-documentor/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: ct-documentor
 description: Documentation coordinator with CLEO style guide compliance. Routes every canonical-doc write (spec, adr, research, handoff, note, llm-readme) through the docs SSoT via `cleo docs add` / `cleo docs publish` / `cleo docs fetch` — never raw filesystem writes. Carries the CLEO writing and review guides as references and coordinates ct-spec-writer and ct-adr-recorder. Use when creating or updating documentation files, consolidating scattered documentation, or validating documentation against style standards. Triggers on documentation tasks, doc update requests, or style guide compliance checks.
-version: 3.17.7
+version: 3.18.0
 protocol: null
 dependencies:
   - ct-spec-writer
@@ -16,13 +16,13 @@ compatibility:
   - gemini-cli
 license: MIT
 metadata:
-  version: 3.17.7
+  version: 3.18.0
   tier: core
   install: harness
   covers:
     - packages/cleo/src/cli/commands/docs.ts
     - packages/contracts/src/docs-taxonomy.ts
-  lastReviewed: 2026-10-10
+  lastReviewed: 2026-10-11
   stability: stable
 ---
 
@@ -156,6 +156,9 @@ Before adding a new doc, ALWAYS ask: is this **a new doc**, **a change to an exi
 │  Tracing the lineage graph?            │ cleo docs graph             │
 │  → "what does this doc replace?"       │   --root <slug>             │
 │  → "what tasks reference this ADR?"    │   (ADVANCED — T10164)       │
+│  Triaging a backlog of stale drafts?   │ cleo docs triage            │
+│  → 2,152 drafts with empty metadata    │   [--limit N] [--record]    │
+│  → verdicts are proposals only         │   (T13446 — no mutation)    │
 └─────────────────────────────────────────────────────────────────────┘
 ```
 

package/skills/manifest.json

@@ -566,7 +566,7 @@
     },
     {
       "name": "ct-dev-workflow",
-      "version": "3.1.16",
+      "version": "3.1.18",
       "description": "Development workflow orchestration for task-driven development with atomic commits, conventional commit messages, and systematic release processes. Enforces task traceability, branch discipline, smart test scope selection, and GitHub Actions integration. Use when committing code, creating releases, managing branches, or following contribution protocols. Triggers on commit operations, release preparation, or workflow compliance needs.",
       "path": "skills/ct-dev-workflow",
       "tier": 0,
@@ -642,7 +642,7 @@
     },
     {
       "name": "ct-documentor",
-      "version": "3.17.7",
+      "version": "3.18.0",
       "description": "Documentation coordinator with CLEO style guide compliance. Routes every canonical-doc write (spec, adr, research, handoff, note, llm-readme) through the docs SSoT via `cleo docs add` / `cleo docs publish` / `cleo docs fetch` — never raw filesystem writes. Carries the CLEO writing and review guides as references and coordinates ct-spec-writer and ct-adr-recorder. Use when creating or updating documentation files, consolidating scattered documentation, or validating documentation against style standards. Triggers on documentation tasks, doc update requests, or style guide compliance checks.",
       "path": "skills/ct-documentor",
       "tier": 0,