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
72%
Does it follow best practices?
Impact
—
No eval scenarios have been run
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.mdQuality
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.'
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
Total | 10 / 11 Passed | |
d00c351
Table of Contents
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.