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.

69

Quality

83%

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

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

A well-structured, token-efficient overview for a hook-based discipline skill: concrete trigger lists, explicit blocking semantics, a decision flowchart with wrong-path documentation, and one verified one-level-deep reference. Main weaknesses are duplicated blocking/non-blocking statements, missing hook configuration examples, and a rules/CLAUDE.md reference that does not resolve within the bundle.

Suggestions

State the blocking/non-blocking semantics once (in the Hook Behavior Reference) and summarize only the hook names in the overview to remove the duplicated explanation.

Add a minimal hooks.json or PreToolUse matcher example so the enforcement described (exits 2, additionalContext injection) is copy-paste implementable.

Either include rules/CLAUDE.md in the bundle or rephrase the Rules section so every referenced path resolves — currently it points at a file that is not shipped.

DimensionReasoningScore

Conciseness

The body is dense and operational (exact extensions, command lists, exit codes, trigger/non-trigger boundaries) with essentially no explanation of concepts Claude already knows. It loses a point because the blocking/non-blocking distinction is stated twice — once in the overview ('The Source File Read Warning and Diagnostic Command Gate are **non-blocking**... The Bash Built-In Tool Enforcement Gate is **blocking**') and repeated per-hook in the Hook Behavior Reference — which could be trimmed.

4 / 5

Actionability

Mostly executable guidance: exact trigger conditions ('grep at start of command (standalone, not pipeline)', 'exits with code 2'), concrete command lists ('ty check', 'ruff check', 'cargo clippy'), and explicit non-triggers. Minor gap: no sample hooks.json/PreToolUse matcher configuration or hook script code, so someone implementing this cannot copy-paste the actual enforcement.

4 / 5

Workflow Clarity

The mermaid flowchart lays out a clear decision sequence with checkpoints (Does orchestrator need current codebase state? → Scope changed? → Present to user for routing decision) plus an explicit wrong-path escalation branch. Not a 5 because there is no recovery guidance after the 'Spot-check agent output' step (what happens when the spot-check fails is undefined), and the decision-tree lacks the validate/fix/retry feedback loop of the top anchor.

4 / 5

Progressive Disclosure

Good structure against the actual bundle: the body is a ~100-line overview, and detailed pattern analysis is correctly split into references/investigation-escalation.md (verified to exist, one level deep, no chained references), clearly signaled in the '### 3. Reference Material' section with a description of its contents. Falls short of 5 because 'The `rules/CLAUDE.md` file is loaded into every session' references a file not present in the bundle, leaving the rules section as an unsubstantiated pointer.

4 / 5

Total

16

/

20

Passed

Description

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

A strong description: third-person voice, concrete enumerated capabilities, an explicit 'Use when...' clause with three distinct natural trigger scenarios, and a clearly differentiated niche. The only weakness is modest synonym variation in trigger terms.

Suggestions

Add natural-language synonyms for trigger scenarios (e.g., 'agent is reading too many files itself', 'delegate vs. do it myself') to broaden natural-term coverage toward the top anchor.

Consider dropping or simplifying implementation jargon like 'PreToolUse hooks' in favor of user-facing phrasing such as 'intercepts tool calls', since the description's job is triggering, not mechanism.

DimensionReasoningScore

Specificity

Quotes multiple specific concrete actions: 'Prevents the orchestrator from reading source files it will not edit, running diagnostic commands that waste context, and rationalizing delegation bypasses' plus 'Activates PreToolUse hooks that surface decision points before source file reads and diagnostic command execution'. This matches the 5 anchor ('lists multiple specific concrete actions; comprehensive coverage') and exceeds the 4 anchor, which implies gaps in coverage.

5 / 5

Completeness

Explicitly answers both questions: what ('Prevents the orchestrator from reading source files it will not edit, running diagnostic commands... and rationalizing delegation bypasses') and when ('Use when setting up orchestrator guardrails, reviewing delegation discipline, or diagnosing context window waste in multi-agent workflows') with concrete trigger phrases. Matches the 5 anchor exactly; clearly better than the 4 anchor where 'when' is only adequately specific.

5 / 5

Trigger Term Quality

Good natural trigger coverage: 'setting up orchestrator guardrails', 'reviewing delegation discipline', 'diagnosing context window waste in multi-agent workflows'. Falls short of the 5 anchor (comprehensive synonyms/extensions, like the 'PDF files, PDFs, forms, .pdf' example) because there are few synonym variations and some jargon ('PreToolUse hooks') dilutes the natural phrasing.

4 / 5

Distinctiveness Conflict Risk

Clear niche with distinct triggers — 'orchestrator context window discipline', 'delegation discipline', 'context window waste in multi-agent workflows' — unlikely to fire for unrelated skills. Not the 4 anchor ('minor overlap risk with closely related skills') since the trigger phrases are role- and symptom-specific rather than broad.

5 / 5

Total

19

/

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