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.

64

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

77%

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

The body is a well-organized, actionable instruction-only skill with a clear sequenced procedure and an explicit validation gate. Its main weaknesses are mild cross-section repetition and a References section that does not align with the actual bundle files.

Suggestions

Dedupe the repeated 'GitHub PRs as delivery evidence, not the tracker of record' and no-code-implementation points so each appears once, tightening conciseness toward a 3.

Fix the References section to point at files that exist in this bundle and link references/context-preservation.md, or note that the Plugins/... paths resolve only in the full installation, so progressive disclosure reflects the real bundle structure.

DimensionReasoningScore

Conciseness

The body is lean and well-sectioned, but repeats guidance verbatim or near-verbatim across sections ('Keep GitHub PRs as delivery evidence, not the tracker of record' appears in Traceability, Constraints, and Gotchas; the no-code-implementation prohibition appears in Constraints and Gotchas), fitting 'mostly efficient but could be tightened'; it is not a 3 because of this redundancy, and not a 1 because it never pads with concepts Claude already knows.

2 / 3

Actionability

Provides concrete, executable specifics: a runnable validation command ('python3 Infrastructure/scripts/validation-and-linting/he_linear_traceability_lint.py <plan-path>'), concrete ID schemes (P/UP, AC/UAC), and a concrete decision set (fresh/resume/deepen); it is not a 2 because key guidance is copy-paste-ready rather than pseudocode or abstract.

3 / 3

Workflow Clarity

The Procedure gives a clean ordered sequence and Validation supplies an explicit checkpoint ('run ... as a required gate', 'Stop at the first failed gate') with a stop-and-fix feedback loop, matching the 'clear sequence with explicit validation steps' anchor; it is not a 2 because validation is explicit, not implicit.

3 / 3

Progressive Disclosure

The References section is well-formed and one level deep, but its paths point to files absent from this bundle (e.g. SKILL.full.md, subagent-routing.md) and the one real bundle reference (references/context-preservation.md) is not linked from the body, fitting 'references present but not clearly signaled'; it is not a 1 because the body is not monolithic or deeply nested, and not a 3 because the references do not resolve to the actual bundle.

2 / 3

Total

10

/

12

Passed

Description

77%

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 clearly states both the skill's purpose and an explicit 'Use when' trigger with multiple concrete input types. It is held back by jargon-laden triggers and only moderate distinctiveness from generic planning skills.

Suggestions

Add user-natural trigger phrases (e.g., 'plan this work', 'sequence these tasks', 'turn this spec into a plan') alongside the internal 'Harness Engineering planning stage' phrasing.

Sharpen distinctiveness by contrasting with execution (e.g., 'produces the plan that he-work then executes') so it is unlikely to be chosen for general planning.

DimensionReasoningScore

Specificity

Names multiple concrete inputs ('specs, brainstorm outputs, bugs, or feature requests') and a concrete transformation action ('Plan execution work ... into an implementation-ready sequence'), matching the 'lists multiple specific concrete actions' anchor; it is not a 2 because it enumerates several concrete actions rather than naming only a domain and a few.

3 / 3

Completeness

Explicitly answers both what ('Plan execution work ... into an implementation-ready sequence') and when ('Use when the user needs the Harness Engineering planning stage before execution'), matching the 'clearly answers both what AND when with explicit triggers' anchor; it is not a 2 because the 'when' is explicit rather than implied.

3 / 3

Trigger Term Quality

Includes some natural terms ('specs', 'brainstorm', 'bugs', 'feature requests') but leans on internal jargon ('Harness Engineering planning stage') and omits common variations a user would actually say; it is not a 1 because natural keywords are present, and not a 3 because coverage is not broad enough.

2 / 3

Distinctiveness Conflict Risk

The he-plan/he-work framing gives it a niche, but the description alone does not cleanly separate it from generic planning skills and the 'Harness Engineering' qualifier is jargon, fitting 'somewhat specific but could still overlap'; it is not a 1 because it is not generic, and not a 3 because the triggers are not cleanly distinguishing.

2 / 3

Total

10

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

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.