CtrlK
BlogDocsLog inGet started
Tessl Logo

he-deepen-spec

Deepen an existing system or UI spec so boundaries, lifecycle rules, failure handling, and validation are strong enough for planning. Use when the user wants Harness Engineering spec hardening or a requirements review pass before planning.

61

Quality

72%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./Plugins/harness-engineering/fixtures/budget-archive/2026-04-21/deferred-store/skills/team_automation/he-deepen-spec/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

75%

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 has good structural completeness with explicit 'what' and 'when' clauses, and occupies a distinct niche. However, the specificity of concrete actions could be improved—'deepen' is vague—and the trigger terms could cover more natural language variations users might employ when requesting this type of work.

Suggestions

Replace the vague verb 'deepen' with specific concrete actions, e.g., 'Identifies missing edge cases, adds boundary conditions, defines lifecycle state transitions, and specifies error handling for existing system or UI specs.'

Expand trigger terms to include natural variations like 'edge cases,' 'spec gaps,' 'tighten requirements,' 'review spec completeness,' or 'harden spec.'

DimensionReasoningScore

Specificity

The description names a domain (system/UI spec hardening) and mentions specific areas like 'boundaries, lifecycle rules, failure handling, and validation,' but these are somewhat abstract categories rather than concrete actions. It says 'deepen' which is vague compared to listing specific operations.

2 / 3

Completeness

The description clearly answers both 'what' (deepen specs so boundaries, lifecycle rules, failure handling, and validation are strong enough for planning) and 'when' (when the user wants spec hardening or a requirements review pass before planning), with an explicit 'Use when' clause.

3 / 3

Trigger Term Quality

Includes some relevant terms like 'spec hardening,' 'requirements review,' 'failure handling,' and 'validation,' but these are somewhat specialized. Terms like 'Harness Engineering' are very specific to a particular context. Missing common variations a user might say like 'edge cases,' 'spec review,' 'tighten requirements,' or 'spec gaps.'

2 / 3

Distinctiveness Conflict Risk

The description carves out a clear niche: hardening existing specs before planning, specifically around boundaries, lifecycle rules, failure handling, and validation. The mention of 'Harness Engineering' and the specific phase ('before planning') make it unlikely to conflict with general spec-writing or planning skills.

3 / 3

Total

10

/

12

Passed

Implementation

70%

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

This is a well-structured instruction-only skill with strong workflow clarity and progressive disclosure. Its main weakness is limited actionability—it describes what to do conceptually but lacks concrete worked examples, templates, or sample outputs that would make the guidance copy-paste ready. Conciseness is adequate but could be tightened by removing some redundant guidance across sections.

Suggestions

Add a worked example showing a before/after spec snippet (e.g., a vague spec passage transformed into one with explicit boundaries, invariants, and acceptance criteria) to improve actionability.

Include a sample output template or schema for the 'Deepened specification' deliverable so Claude knows the exact structure expected.

Consolidate the anti-patterns and validation sections to reduce redundancy—several anti-patterns are just negations of validation gates.

DimensionReasoningScore

Conciseness

The skill is reasonably structured but includes some redundancy (e.g., the anti-patterns section partially restates validation gates, and the philosophy section restates what the procedure already implies). The 'Progressive Disclosure Entry' preamble and some meta-commentary could be trimmed. However, it largely avoids explaining concepts Claude already knows.

2 / 3

Actionability

The procedure provides a clear sequence of steps and the domain-consistency and interface-design passes give concrete criteria, but there are no executable code examples, no template outputs, and no concrete before/after spec snippets. The 'Examples' section only shows prompt phrases rather than worked examples with expected outputs.

2 / 3

Workflow Clarity

The procedure is clearly sequenced (steps 1-7) with explicit validation gates, a fail-fast policy, and blocking conditions (e.g., 'Block planning when a required interface shape is still unresolved'). The validation section serves as an explicit checkpoint list with a feedback loop ('stop at first failed gate'). This is strong for a non-code, instruction-only skill.

3 / 3

Progressive Disclosure

The skill explicitly positions itself as a concise entrypoint with well-signaled one-level-deep references to canonical contracts, eval cases, task profiles, subagent routing, domain model routing, and assets. Navigation is clear and references are organized by purpose. However, no bundle files were provided to verify path accuracy, so scoring is based on the structure as presented.

3 / 3

Total

10

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

10

/

11

Passed

Repository
jscraik/Agent-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.