CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

subagent-contract

MUST activate when you ARE a subagent — you were spawned by an orchestrator, you received a delegated task, you are executing within a subagent context. Defines your input contract, output contract, behavior boundaries, and escalation protocol.

Quality

86%

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

86%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 tight, well-structured contract body that respects the token budget and covers the full subagent lifecycle with explicit stop-and-ask checkpoints. The only soft spots are a few vague directives and the absence of a concrete example of the required return format.

Suggestions

Replace or tighten the vague directives — 'Keep standard agent tools available as required' and 'Initialize required skills on start' give no testable criterion for compliance.

Add a short example of the required return payload (e.g., a skeleton with Summary/Side effects/Anomalies/Deviations fields) so the output contract is copy-paste concrete rather than enumerated abstractly.

DimensionReasoningScore

Conciseness

The ~40-line body is extremely lean: every rule is a single terse directive ("Do not improvise beyond scope", "Lightweight = small clear tasks") with zero padding and zero explanation of concepts Claude already knows. Every token earns its place, matching the 'lean and efficient' anchor.

5 / 5

Actionability

Most rules are executable directives — "Write to unique file path defined by orchestrator", "If instructions are ambiguous, STOP and ask orchestrator before executing", and a concrete enumerated return format ("concise results, summary, side effects, anomalies, discoveries, contract changes, deviations, inconsistencies, and insights"). Minor gaps remain: rules like "Keep standard agent tools available as required" and "Initialize required skills on start" are vague, and there is no example of what a compliant return/output actually looks like.

4 / 5

Workflow Clarity

The body is organized as a lifecycle (Identity → Input contract → Output contract → Behavior) with explicit checkpoints: a pre-execution gate ("If instructions are ambiguous, STOP and ask orchestrator before executing") and an execution gate ("MUST STOP and EXPLAIN if cannot execute as requested or off-plan"). It is a behavioral contract rather than a numbered procedure, so the sequence is implicit rather than spelled out step-by-step, keeping it below the anchor-5 pattern.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external references (no references/, scripts/, or assets/ bundle exists), and the body is well-organized into clearly signaled sections (process with Identity/Input/Output/Behavior subsections, plus a pitfalls section). Per the rubric's simple-skill guidance, this merits a 5 with well-organized sections alone.

5 / 5

Total

18

/

20

Passed

Description

82%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, distinctive description with an explicit and unusually concrete activation trigger. Its main weaknesses are second-person voice (explicitly penalized by the guidelines) and capability language that stays at the abstract 'contract' level rather than describing concrete behaviors.

Suggestions

Rewrite in third person to avoid the second-person penalty: e.g., 'Defines the input contract, output contract, behavior boundaries, and escalation protocol for spawned subagents.'

Make the capability statement more concrete: instead of 'Defines your input contract...', briefly enumerate observable behaviors such as 'directs the subagent to write results to the orchestrator-defined file path, stop and ask when instructions are ambiguous, and report deviations and anomalies'.

Add one or two natural trigger synonyms (e.g., 'delegated task', 'spawned worker', 'orchestration step') to lift trigger coverage from good to comprehensive.

DimensionReasoningScore

Specificity

The description lists four named deliverables ("Defines your input contract, output contract, behavior boundaries, and escalation protocol"), but these are abstract categories rather than concrete actions a reader can picture executing — closer to "Processes PDF files and extracts content" than to "Extracts text, fills forms, converts pages". It also uses second person throughout ("you ARE a subagent", "your input contract"), which the guidelines penalize by reducing the specificity score by 1 from an already borderline 3/4 base.

3 / 5

Completeness

Both 'what' ("Defines your input contract, output contract, behavior boundaries, and escalation protocol") and 'when' ("MUST activate when you ARE a subagent") are explicitly answered, with three concrete trigger conditions in the when-clause. This matches the anchor-5 pattern of explicit what-and-when with concrete trigger phrases, not the anchor-4 pattern where the when is generic.

5 / 5

Trigger Term Quality

Natural trigger phrases are well covered: "you were spawned by an orchestrator", "you received a delegated task", "you are executing within a subagent context" — terms an orchestrator or user would naturally say. A few natural synonyms (e.g., 'worker', 'delegation', 'fan-out task') are missing, so it falls short of the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

The trigger condition — being a spawned subagent inside an orchestration — is a clear niche with distinct triggers and minimal overlap risk with ordinary user-facing skills. Even other orchestration skills would not fire on 'you ARE a subagent' phrasing.

5 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

griddynamics/rosetta

Path

instructions/r2/core/skills/subagent-contract/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.