@cleocode/skills 2026.11.13 → 2026.11.14
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json
CHANGED
|
@@ -114,8 +114,10 @@ Reference: @skills/_shared/task-system-integration.md
|
|
|
114
114
|
```
|
|
115
115
|
|
|
116
116
|
Do not start another session or re-claim a preallocated task. Export the allocated
|
|
117
|
-
`CLEO_SESSION_ID` and `CLEO_AGENT_ID` on every command.
|
|
118
|
-
|
|
117
|
+
`CLEO_SESSION_ID` and `CLEO_AGENT_ID` on every command. An expired claim lease on your own
|
|
118
|
+
task is not a blocker: renew it with `cleo claim {{TASK_ID}} --renew` and carry on. A missing
|
|
119
|
+
session, or a claim another session now holds (the renewal is refused with `E_TASK_CLAIMED`),
|
|
120
|
+
returns blocked to the coordinator for handoff; never replace it yourself.
|
|
119
121
|
|
|
120
122
|
---
|
|
121
123
|
|
|
@@ -225,5 +227,5 @@ If work cannot proceed:
|
|
|
225
227
|
| Returning full content | Bloats orchestrator context | Return only summary message |
|
|
226
228
|
| Manual JSONL append | No validation, race conditions | Use `cleo research add` |
|
|
227
229
|
| Missing manifest entry | Orchestrator can't find findings | Always create manifest entry |
|
|
228
|
-
| Starting or re-claiming a preallocated task | Replaces the worker binding or steals a claim | Preserve the allocated session and claim.
|
|
230
|
+
| Starting or re-claiming a preallocated task | Replaces the worker binding or steals a claim | Preserve the allocated session and claim. Renew your own expired lease with `cleo claim {{TASK_ID}} --renew`; a missing session or a claim another session holds returns blocked to the coordinator for handoff. |
|
|
229
231
|
| Incomplete checklist | Protocol violation | Verify all items before return |
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: ct-orchestrator
|
|
3
3
|
description: "Pipeline-aware orchestration skill for managing complex workflows through subagent delegation. Use when the user asks to \"orchestrate\", \"orchestrator mode\", \"run as orchestrator\", \"delegate to subagents\", \"coordinate agents\", \"spawn subagents\", \"multi-agent workflow\", \"context-protected workflow\", \"agent farm\", \"HITL orchestration\", \"pipeline management\", or needs to manage complex workflows by delegating work to subagents while protecting the main context window. Enforces ORC-001 through ORC-009 constraints. Provider-neutral — works with any AI agent runtime."
|
|
4
4
|
metadata:
|
|
5
|
-
version: 4.
|
|
5
|
+
version: 4.25.0
|
|
6
6
|
tier: core
|
|
7
7
|
install: harness
|
|
8
8
|
covers:
|
|
@@ -298,8 +298,15 @@ since harness shells keep neither cwd nor env between calls (the git shim reads
|
|
|
298
298
|
same identity line in its Session Linkage block: both `CLEO_SESSION_ID` and `CLEO_AGENT_ID`,
|
|
299
299
|
so teammates sharing one harness session keep separate claims and focus (T14269).
|
|
300
300
|
The prompt names the allocated **Worker Session** and the separate **Coordinator Session**;
|
|
301
|
-
workers preserve the preclaim and never start a session or re-claim.
|
|
302
|
-
|
|
301
|
+
workers preserve the preclaim and never start a session or re-claim. A worker's lease
|
|
302
|
+
renews with every CLEO command it runs (reads included) and with the heavy-command hook's beat
|
|
303
|
+
before each shell command, so it stays live while the worker is (T14546). The hook binds a
|
|
304
|
+
worker by its process (a `CLEO_SESSION_ID` in the harness environment, else the worktree
|
|
305
|
+
lock of the directory it runs in), never by command text, and renews only while that
|
|
306
|
+
session holds the claim, so launch workers in their task worktree. A worker whose
|
|
307
|
+
lease still lapsed renews it itself with `cleo claim <id> --renew` and carries on; no resume
|
|
308
|
+
spawn is needed. Only a refused renewal (`E_TASK_CLAIMED`: another session took the task)
|
|
309
|
+
or an ended session returns to the coordinator for handoff. Execution backends receive `workerSession`
|
|
303
310
|
separately from `coordinatorSessionId`; a CLI's own environment does not prove Orca's
|
|
304
311
|
launched worker inherited it.
|
|
305
312
|
`workerSession.role` comes from dispatch and controls the shell binding (worker by
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: ct-task-executor
|
|
3
3
|
description: General implementation task execution for completing assigned CLEO tasks by following instructions and producing concrete deliverables. Handles coding, configuration, documentation work with quality verification against acceptance criteria and progress reporting. Use when executing implementation tasks, completing assigned work, or producing task deliverables. Triggers on implementation tasks, general execution needs, or task completion work.
|
|
4
|
-
version: 2.
|
|
4
|
+
version: 2.15.0
|
|
5
5
|
protocol: implementation
|
|
6
6
|
adrRefs:
|
|
7
7
|
- ADR-070
|
|
@@ -17,7 +17,7 @@ compatibility:
|
|
|
17
17
|
- gemini-cli
|
|
18
18
|
license: MIT
|
|
19
19
|
metadata:
|
|
20
|
-
version: 2.
|
|
20
|
+
version: 2.15.0
|
|
21
21
|
tier: core
|
|
22
22
|
install: harness
|
|
23
23
|
covers:
|
|
@@ -351,11 +351,20 @@ cleo complete T1234 --if-match <updatedAt>
|
|
|
351
351
|
task. If another session holds it, the start is refused with `E_TASK_CLAIMED`
|
|
352
352
|
and nothing is written; `error.details` names the `holder` (session, agent,
|
|
353
353
|
`leaseExpiresAt`), whether the lease has `expired`, and the `override` flag.
|
|
354
|
-
Your
|
|
355
|
-
|
|
354
|
+
Your activity renews your leases (T14546): every mutation, a read once half the
|
|
355
|
+
lease is gone, and, where the heavy-command hook is installed, the shell commands
|
|
356
|
+
you run. The hook knows you by your process, never by your command text: a
|
|
357
|
+
`CLEO_SESSION_ID` in your harness environment, else the task worktree you run in
|
|
358
|
+
(its spawn lock), and only while you hold the claim. `cleo stop`, `cleo complete` and
|
|
359
|
+
ending your session release them. The human `assignee` is a separate field.
|
|
360
|
+
|
|
361
|
+
An expired lease on your own task is not a reason to stop. Renew it and carry
|
|
362
|
+
on; while no other session has claimed the task, the renewal revives it. If the
|
|
363
|
+
renewal is refused with `E_TASK_CLAIMED`, another session holds the task now:
|
|
364
|
+
stop and report that holder to your orchestrator.
|
|
356
365
|
|
|
357
366
|
```bash
|
|
358
|
-
cleo claim T1234 --renew # extend your lease
|
|
367
|
+
cleo claim T1234 --renew # extend your lease, or revive your own expired one
|
|
359
368
|
cleo start T1234 --take-over # holder's lease EXPIRED (audited)
|
|
360
369
|
cleo start T1234 --force-claim # holder is LIVE: only with a clear reason (audited)
|
|
361
370
|
```
|
package/skills/manifest.json
CHANGED
|
@@ -922,7 +922,7 @@
|
|
|
922
922
|
},
|
|
923
923
|
{
|
|
924
924
|
"name": "ct-orchestrator",
|
|
925
|
-
"version": "4.
|
|
925
|
+
"version": "4.25.0",
|
|
926
926
|
"description": "Pipeline-aware orchestration skill for managing complex workflows through subagent delegation. Use when the user asks to \\\"orchestrate\\\", \\\"orchestrator mode\\\", \\\"run as orchestrator\\\", \\\"delegate to subagents\\\", \\\"coordinate agents\\\", \\\"spawn subagents\\\", \\\"multi-agent workflow\\\", \\\"context-protected workflow\\\", \\\"agent farm\\\", \\\"HITL orchestration\\\", \\\"pipeline management\\\", or needs to manage complex workflows by delegating work to subagents while protecting the main context window. Enforces ORC-001 through ORC-009 constraints. Provider-neutral — works with any AI agent runtime.",
|
|
927
927
|
"path": "skills/ct-orchestrator",
|
|
928
928
|
"tier": 0,
|
|
@@ -1410,7 +1410,7 @@
|
|
|
1410
1410
|
},
|
|
1411
1411
|
{
|
|
1412
1412
|
"name": "ct-task-executor",
|
|
1413
|
-
"version": "2.
|
|
1413
|
+
"version": "2.15.0",
|
|
1414
1414
|
"description": "General implementation task execution for completing assigned CLEO tasks by following instructions and producing concrete deliverables. Handles coding, configuration, documentation work with quality verification against acceptance criteria and progress reporting. Use when executing implementation tasks, completing assigned work, or producing task deliverables. Triggers on implementation tasks, general execution needs, or task completion work.",
|
|
1415
1415
|
"path": "skills/ct-task-executor",
|
|
1416
1416
|
"tier": 0,
|