CtrlK
BlogDocsLog inGet started
Tessl Logo

orchestrator-discipline

Orchestrator context window discipline enforcement. Prevents the orchestrator from reading source files it will not edit, running diagnostic commands that waste context, and rationalizing delegation bypasses. Use when setting up orchestrator guardrails, reviewing delegation discipline, or diagnosing context window waste in multi-agent workflows. Activates PreToolUse hooks that surface decision points before source file reads and diagnostic command execution.

59

Quality

68%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/orchestrator-discipline/skills/orchestrator-discipline/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

68%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.

The content is concise and actionable, giving concrete match rules and exit codes for each hook rather than abstract description. Its weakest area is workflow clarity: the enforcement flow lacks explicit validation checkpoints and error-recovery feedback loops for what is effectively a batch/destructive gate.

Suggestions

Add an explicit validation/verification checkpoint to the workflow — e.g. how to confirm a hook fired correctly, how to inspect the injected additionalContext, and a feedback loop (hook misfires -> adjust match pattern -> re-test).

Move the large inline hook-behavior reference tables into a separate references file (one level deep) to tighten the SKILL.md overview and improve progressive disclosure.

Add a short concrete example of the actual hook script or additionalContext payload format so the enforcement behavior is copy-paste ready rather than described.

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's competence, listing hook triggers as concrete match rules rather than explaining what hooks or context windows are; a few sections restate the blocking-vs-non-blocking distinction and SOURCE provenance lines that could be trimmed slightly.

4 / 5

Actionability

It provides concrete, executable guidance — explicit extension lists, command match patterns, exit-code-2 blocking behavior, and pipeline exceptions — with only minor gaps (e.g. the exact hook script path or how additionalContext is formatted is not shown).

4 / 5

Workflow Clarity

The mermaid flowchart lays out a clear decision sequence, but the core operation (running hooks that block or warn on tool calls) has no explicit validation/verification checkpoints or error-recovery feedback loops; per the rubric, workflows involving batch/destructive enforcement without validation cap at 3.

3 / 5

Progressive Disclosure

Structure is good: an overview with well-signaled one-level-deep reference to ./references/investigation-escalation.md (which exists), and hook details kept inline rather than buried; minor gap is that some inline hook-behavior tables could live in a dedicated reference file.

4 / 5

Total

15

/

20

Passed

Description

67%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 is specific and clearly scoped to a distinct niche, covering both what the skill does and when to use it. Its main weakness is trigger-term naturalness — the vocabulary is technical and would rarely match a user's plain-language request without them already knowing the concept.

Suggestions

Add plain-language trigger phrases users would actually say (e.g. 'Use when an orchestrator agent keeps reading code files instead of delegating, or when a session's context fills up from redundant diagnostic runs').

Include natural synonyms or common phrasings (e.g. 'context bloat', 'delegation bypass', 'orchestrator reading too much') to improve trigger-term coverage beyond the current technical jargon.

DimensionReasoningScore

Specificity

Names the domain (orchestrator context window discipline) and lists several concrete actions — 'Prevents the orchestrator from reading source files it will not edit, running diagnostic commands that waste context, and rationalizing delegation bypasses' and 'Activates PreToolUse hooks that surface decision points before source file reads and diagnostic command execution' — with only minor coverage gaps.

4 / 5

Completeness

It states both what it does (prevents specific wasteful orchestrator behaviors, activates PreToolUse hooks) and when to use it ('Use when setting up orchestrator guardrails, reviewing delegation discipline, or diagnosing context window waste'), though the 'when' trigger could be slightly more explicit about the most common natural scenario.

4 / 5

Trigger Term Quality

It includes some relevant phrases a user might say ('reviewing delegation discipline', 'diagnosing context window waste in multi-agent workflows'), but the natural trigger terms are specialized jargon (orchestrator, hooks, guardrails) rather than the everyday phrases a user would naturally utter, and synonyms/common variations are thin.

3 / 5

Distinctiveness Conflict Risk

The niche is clearly scoped to the orchestrator role and context-window discipline in multi-agent workflows, with distinct triggers unlikely to fire for unrelated skills; only minor overlap risk with general delegation or review skills.

4 / 5

Total

15

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
Jamie-BitFlight/claude_skills
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.