CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-intent-contract

Use when starting a complex or ambiguous task that risks scope drift

46

Quality

49%

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 ./.claude/skills/skill-intent-contract/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

62%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-sequenced, highly actionable instruction skill with genuine novel guidance on human-AI task allocation, dragged down by significant redundancy (the contract template repeated three times, marketing-style Benefits section) and broken script references in a bundle that contains only SKILL.md.

Suggestions

Eliminate the duplicate contract templates: keep the Step 2 heredoc as the single authoritative template and cut the structure section and worked example, or move the worked example to an EXAMPLES.md reference file.

Delete the 'Benefits' and 'Purpose' bullet sections and the 'Ready to use!' closer — these pitch the skill rather than instruct Claude.

Ship the referenced scripts (plan-storage.sh, routing.sh) in a scripts/ directory or remove/inline the exact invocations, since the commands are currently unexecutable as bundled.

DimensionReasoningScore

Conciseness

The intent contract template appears three times in near-full form — the structure section (lines 26-79), the Step 2 heredoc (lines 241-275), and the full worked example (lines 387-435) — plus padded sections like 'Benefits' ('Clear expectations set upfront', 'Closed-loop accountability') and the closing 'Ready to use!' line. This is noticeably verbose with several redundant/padded sections, though the allocation framework itself is dense novel guidance.

2 / 5

Actionability

Concrete, mostly executable guidance throughout: exact bash for resolving the plan directory and writing session-intent.md, a complete AskUserQuestion payload, exact status-transition mappings, and a validation report template. Minor gaps: shell placeholders like ${USER_GOAL}/${MIN_SUCCESS_CRITERIA} are undefined, and the referenced scripts (plan-storage.sh, routing.sh) are not part of the bundle.

4 / 5

Workflow Clarity

Steps 0-5 are clearly sequenced with explicit validation checkpoints, a checklist, and a validation-report loop with gap remediation ('If any criteria not met, list concrete next steps'), plus a feedback loop for intermediate risk (record 'pending-user-decision', stop, ask, rewrite the allocation, then continue). Not score 4 territory: every phase has an explicit checkpoint and error-recovery path.

5 / 5

Progressive Disclosure

Section structure is good (## headers, tables, numbered steps), but the entire skill is a monolithic ~450-line file with no bundle files — the example contract, workflow-integration details, and allocation tables could live in separate reference files. Worse, the body references 'scripts/plan-storage.sh' and 'scripts/lib/routing.sh' which do not exist in the bundle, so those references are broken. Not 4: references present but unverifiable and content that should be separate is inline.

3 / 5

Total

14

/

20

Passed

Description

36%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 a clean, natural trigger clause but only answers 'when' — it omits the 'what' entirely, so a user (or Claude) cannot tell what the skill actually does. Adding one sentence of concrete capabilities would move it from a 2 to a 4-5.

Suggestions

Lead with what the skill does, e.g. 'Creates a persistent intent contract that captures user goals, success criteria, and boundaries, and validates final output against them.'

Broaden trigger coverage with common user phrasings: scope creep, requirements drift, defining success criteria, setting goals before a multi-phase task.

Drop or sharpen the generic 'complex or ambiguous task' framing to reduce overlap with general planning/scoping skills.

DimensionReasoningScore

Specificity

The description names a domain ('complex or ambiguous task that risks scope drift') but describes zero concrete actions — it never says what the skill does (create an intent contract, capture success criteria and boundaries, validate outputs). This matches 'names the domain but actions are minimal or generic'; not 3, which requires 1-2 concrete actions to be stated.

2 / 5

Completeness

Only the 'when' is present ('Use when starting a complex or ambiguous task that risks scope drift') with no 'what' whatsoever — the reader cannot tell the skill creates and validates intent contracts. This matches the anchor 'only when is present without what'; not 3, because a clear 'what' is entirely absent rather than weakly implied.

2 / 5

Trigger Term Quality

'complex or ambiguous task' and 'scope drift' are natural, relevant phrases, but common variations users would actually say are missing: 'scope creep', 'requirements drift', 'define success criteria', 'intent contract', 'plan goals'. Fits 'some relevant keywords but missing common variations or synonyms'; not 4 because several obvious user phrasings are absent.

3 / 5

Distinctiveness Conflict Risk

'Scope drift' is a reasonably distinctive trigger, but 'complex or ambiguous task' is broad and would overlap with planning, scoping, and requirements-gathering skills. Fits 'somewhat specific but could still overlap with similar skills'; not 4 because the generic first half invites conflicts.

3 / 5

Total

10

/

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

referenced_paths_exist

Referenced path issues: 2 missing, 1 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository
nyldn/claude-octopus
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.