CtrlK
BlogDocsLog inGet started
Tessl Logo

he-plan

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

Quality

62%

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-plan/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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'.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

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.