Plan execution work from specs, brainstorm outputs, bugs, or feature requests into an implementation-ready sequence. Use when the user needs the Harness Engineering planning stage before execution.
55
62%
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-plan/SKILL.mdQuality
Discovery
67%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 a clear structure with both 'what' and 'when' clauses, which is good for completeness. However, the specific actions are somewhat abstract ('plan execution work') rather than listing concrete deliverables, and the trigger terms could be broader to capture more natural user phrasings. The 'Harness Engineering' reference adds some distinctiveness but may be too niche for general discoverability.
Suggestions
Add more concrete actions/deliverables, e.g., 'Creates task breakdowns, dependency graphs, and ordered implementation steps from specs, bugs, or feature requests'.
Expand trigger terms in the 'Use when' clause with natural variations like 'break down tasks', 'plan implementation', 'create a task list', 'prioritize work', or 'sprint planning'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | It names the domain (planning/execution) and some actions ('plan execution work', 'brainstorm outputs'), but the actions are not very concrete — 'plan execution work from specs' is somewhat vague and doesn't list specific deliverables or steps like 'create task breakdown, estimate effort, identify dependencies'. | 2 / 3 |
Completeness | It answers both 'what' (plan execution work from specs, brainstorm outputs, bugs, or feature requests into an implementation-ready sequence) and 'when' (Use when the user needs the Harness Engineering planning stage before execution) with an explicit 'Use when' clause. | 3 / 3 |
Trigger Term Quality | Includes some relevant terms like 'specs', 'bugs', 'feature requests', 'planning stage', and 'implementation-ready sequence', but misses common natural variations users might say such as 'break down tasks', 'plan work', 'prioritize', 'roadmap', 'task list', or 'sprint planning'. The term 'Harness Engineering' is very specific jargon that may help or hurt depending on context. | 2 / 3 |
Distinctiveness Conflict Risk | The mention of 'Harness Engineering planning stage' provides some distinctiveness as a branded/specific workflow, but the general concept of 'planning work from specs and feature requests' could overlap with generic project management or task breakdown skills. The niche is somewhat clear but not sharply delineated. | 2 / 3 |
Total | 9 / 12 Passed |
Implementation
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a reasonably well-structured planning skill that effectively uses progressive disclosure and maintains appropriate scope. Its main weaknesses are redundancy across sections (the same constraints repeated in multiple places) and insufficient concrete examples — the skill would benefit greatly from a sample plan output, traceability matrix format, or frontmatter template to make the guidance truly actionable rather than procedural.
Suggestions
Add a concrete example of expected plan output showing phase IDs, acceptance IDs, traceability matrix format, and Linear Work Item Contract frontmatter structure.
Consolidate repeated guidance ('GitHub PRs as delivery evidence not tracker of record' appears 3 times; Gotchas largely duplicates Constraints) to improve token efficiency.
Expand the 4-step Procedure with more specific sub-steps or integrate the Core Contract decision logic directly into the procedure flow for clearer workflow sequencing.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is mostly efficient but has some redundancy — 'Keep GitHub PRs as delivery evidence, not the tracker of record' appears three times across different sections. The Gotchas section largely repeats Constraints. Some sections like Philosophy and Anti-patterns add marginal value. However, it generally avoids explaining concepts Claude already knows. | 2 / 3 |
Actionability | The skill provides a concrete validation command (`python3 Infrastructure/scripts/validation-and-linting/he_linear_traceability_lint.py <plan-path>`) and specific ID conventions (P, UP, AC, UAC), but most guidance remains at the procedural/conceptual level without concrete examples of actual plan output, traceability matrix format, or frontmatter structure. The examples section only shows trigger phrases, not input/output examples. | 2 / 3 |
Workflow Clarity | The Procedure section provides a clear 4-step sequence and the Validation section includes a 'stop at first failed gate' checkpoint. However, the procedure steps are quite high-level (e.g., 'Decompose work into ordered, verifiable units') without detailed sub-steps, and the feedback loop between validation failure and correction is only implicit. The Core Contract adds sequencing logic but it's separated from the procedure, making the full workflow harder to follow. | 2 / 3 |
Progressive Disclosure | The skill provides a clear overview with well-signaled one-level-deep references at the bottom. References to full guide, plan artifact contract, verification-first planning, production controls, and routing files are clearly labeled and organized. The main body stays concise while pointing to detailed materials for deeper context. | 3 / 3 |
Total | 9 / 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 | |
4c78f98
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.