CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

control-session-orchestrator

Control-plane workflow for coordinating multi-agent, multi-session project work from a single Codex, GitHub Copilot, or agent-app control session. Use this skill whenever the user asks to orchestrate agents, create or steer worker sessions, run a workflow-like effort, fan out audits/research/migrations, coordinate parallel implementation streams, monitor other project sessions, or compare this control-session pattern to Claude Code dynamic workflows. This skill is especially relevant when the current session can spawn persistent project sessions and those sessions can spawn their own subagents, creating a two-level orchestration hierarchy.

68

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

85%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exceptionally actionable, well-sequenced orchestration procedure with explicit validation gates, retry/escalation loops, and a durable state contract — everything needed to execute is on the page. Its weaknesses are a monolithic single-file structure that should push the manifest schema and contract details into references, and rule repetition (in_flight, batch_guard) across sections that could be consolidated.

Suggestions

Move the full control-state manifest schema, the control-result worker contract, and the app-capability matrix into references/ files (e.g., references/control-state-schema.md, references/worker-contract.md) and signal them from the body, keeping SKILL.md as a compact overview.

State the in_flight budget accounting once (in the manifest rules or Step 4) and cross-reference it from the other two locations instead of repeating the increment/decrement/recompute rules three times.

Consolidate the batch_guard material — currently spread across the manifest rules, Step 4's pilot section, and Step 6 — into a single place, keeping only a one-line pointer where the other mentions occur.

DimensionReasoningScore

Conciseness

The body is dense and assumes competence — no filler, no explanations of concepts Claude already knows, and every section encodes operational rules. However, redundancy is more than trivially minor: in_flight accounting is stated three times (manifest rules, Step 0, Step 4's atomic-update paragraph) and the batch_guard rules are repeated across the manifest rules, Step 4, and Step 6, so it sits between anchors 3 and 4 but noticeably above the midpoint.

4 / 5

Actionability

Copy-paste-ready artifacts throughout: the complete worker prompt template, the full control-result JSON block, the complete control-state manifest schema with example values, exact status enums, and explicit budget arithmetic. The app-agnostic placeholder surface ("thread-or-session id/link", "use the tools exposed in the current environment") is explicitly and legitimately justified, and concrete example commands ("pnpm test auth") are given.

5 / 5

Workflow Clarity

Steps 0–8 are clearly sequenced with explicit validation checkpoints and error-recovery feedback loops: the result-gate (schema validation, one standardized re-prompt, cap of 2 retries, escalate), the wave-join/completeness gate requiring all units in terminal states, the batch pilot-then-pause guard with normalized failure signatures, and the pull-cadence rule. This matches the anchor-5 shape of sequence + explicit validation + recovery loops.

5 / 5

Progressive Disclosure

Sections are well-organized with clear headers and an internal anchor link, but the skill is a ~415-line monolith with no bundle files at all. Content that clearly belongs in separate references — the full control-state manifest schema (~40 lines), the machine-checkable contract definitions, and the app-capability matrix — is inlined, matching anchor 3 ("content that should be separate is inline") rather than anchor 4's mostly-split structure.

3 / 5

Total

17

/

20

Passed

Description

78%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description answers what and when explicitly with a rich set of natural trigger phrases and a distinct, well-scoped niche. Its main weakness is that the capability statement is a single abstract formulation rather than a list of concrete operations, and a few natural trigger phrasings known from the body are missing.

DimensionReasoningScore

Specificity

The description's 'what' is a single abstract capability — "Control-plane workflow for coordinating multi-agent, multi-session project work" — with the apps named ("Codex, GitHub Copilot, or agent-app") but no list of several concrete actions. It is above anchor 2 (which has no meaningful action content) but below anchor 4, which expects several specific listed actions; the concrete verbs here mostly appear as trigger phrases rather than capability descriptions.

3 / 5

Completeness

Both halves are explicit: the what ("Control-plane workflow for coordinating multi-agent, multi-session project work") and a full when-clause ("Use this skill whenever the user asks to orchestrate agents, create or steer worker sessions, run a workflow-like effort...") with concrete trigger phrases and an extra applicability condition. Matches the anchor-5 example structure exactly.

5 / 5

Trigger Term Quality

Strong natural phrase coverage: "orchestrate agents", "create or steer worker sessions", "run a workflow-like effort", "fan out audits/research/migrations", "coordinate parallel implementation streams", "monitor other project sessions". Not anchor 5 because a few natural user phrasings the body itself recognizes (e.g., "spin up sessions", "make workers handle this", "act as control") are absent from the description.

4 / 5

Distinctiveness Conflict Risk

The niche is clear — two-level session-native orchestration on named control apps — and it explicitly disambiguates the closest neighbor ("compare this control-session pattern to Claude Code dynamic workflows"). Not 5 because generic asks like "orchestrate agents" or "run a workflow" could still match broader agent-orchestration skills, giving minor overlap risk.

4 / 5

Total

16

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

pskoett/pskoett-ai-skills

Path

plugin/skills/control-session-orchestrator/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.