@cleocode/skills 2026.10.13 → 2026.10.14

package/package.json

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

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.25.1
+version: 3.25.2
 protocol: null
 dependencies:
   - ct-spec-writer
@@ -16,7 +16,7 @@ compatibility:
   - gemini-cli
 license: MIT
 metadata:
-  version: 3.25.1
+  version: 3.25.2
   tier: core
   install: harness
   covers:
@@ -729,9 +729,16 @@ the docs graph — never grep the filesystem for the file you just wrote.
 cleo docs list --type spec --project       # canonical: every spec in this project
 cleo docs list --task T1234                # canonical: everything attached to a task
 cleo docs versions --for T1234             # ADVANCED: list every SHA version
+cleo docs versions --for my-doc-slug       # ADVANCED: same, resolved from a doc slug
 cleo docs sync --from docs/legacy.md --for T1234  # ADVANCED: back-fill on-disk file into SSoT (no --type/--slug; classify with docs add)
 ```
 
+`docs versions --for` resolves owner id first, then slug. An owner id
+(`T###`, `ses_*`, `O-*`) is listed as-is, even when empty. Any other arg is
+looked up as a doc slug and lists its owning task's blobs, sibling docs
+included (add `--name <blob>` to narrow). An arg that is neither fails with
+`E_NOT_FOUND`.
+
 ---
 
 ## Deprecated: Direct filesystem

package/skills/ct-lean/SKILL.md

@@ -8,12 +8,13 @@ description: >-
   gates, package boundaries, validation, data safety or anything the task asked for.
 license: MIT
 metadata:
-  version: 1.1.0
+  version: 1.2.0
   tier: core
   install: harness
   covers:
     - packages/core/src/orchestration/lean-change.ts
     - packages/cleo/src/cli/commands/lean.ts
+    - packages/core/src/orchestration/lean-debt.ts
   lastReviewed: 2026-10-13
   stability: stable
   attribution: Adapted from Ponytail 5.1.0 by DietrichGebert (MIT) — https://github.com/DietrichGebert/ponytail
@@ -76,6 +77,8 @@ callers that stop working, stores it would migrate. That is scope. Extra feature
 - New non-trivial logic (a branch, a loop, a parser, a store write, security) leaves one
   small test. Trivial changes need none. Run single test files through `cleo run --wait`.
 - A shortcut with a known limit gets a comment: `shortcut: <the limit>, <when to upgrade>`.
+  `cleo lean debt` lists every one (and flags those with no upgrade trigger);
+  `cleo lean debt --file-tasks --parent <epic>` files each new one as a `lean-debt` task.
 
 ## Never cut
 

package/skills/manifest.json

@@ -642,7 +642,7 @@
     },
     {
       "name": "ct-documentor",
-      "version": "3.25.1",
+      "version": "3.25.2",
       "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,
@@ -983,7 +983,7 @@
     },
     {
       "name": "ct-lean",
-      "version": "1.1.0",
+      "version": "1.2.0",
       "description": "Lean change discipline for CLEO work: the smallest change that fully solves the task, and a reply a busy owner understands in one read. Use on every coding task (writing, fixing, refactoring, reviewing, choosing dependencies) and when the owner asks for the simplest solution, YAGNI, or complains about over-engineering or bloat. Never trades away evidence gates, package boundaries, validation, data safety or anything the task asked for.",
       "path": "skills/ct-lean",
       "tier": 0,