CtrlK
BlogDocsLog inGet started
Tessl Logo

he-strategy

Compress HE cognition artifacts into evidence-backed strategy. Use when intent, review, triage, ADR, core, or source-prompt comparison evidence needs durable direction.

36

Quality

33%

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/skills/he-strategy/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

25%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This description is heavily laden with domain-specific jargon ('HE cognition artifacts', 'durable direction', 'source-prompt comparison evidence') that obscures both what the skill does and when it should be used. While it includes a 'Use when' clause, the trigger terms are either too abstract or too generic to reliably guide skill selection. The description fails to communicate concrete actions in plain language.

Suggestions

Replace jargon with plain-language descriptions of concrete actions (e.g., instead of 'compress HE cognition artifacts', specify what inputs are processed and what outputs are produced).

Rewrite trigger terms using natural language a user would actually say — spell out what 'HE cognition artifacts' means and what 'durable direction' looks like as an output.

Expand the 'Use when' clause with specific, recognizable scenarios rather than abstract conditions like 'evidence needs durable direction'.

DimensionReasoningScore

Specificity

The description uses abstract, jargon-heavy language like 'HE cognition artifacts' and 'evidence-backed strategy' without listing concrete actions. 'Compress' is vague and no specific outputs or operations are described.

1 / 3

Completeness

It attempts to answer both 'what' (compress cognition artifacts into strategy) and 'when' (when evidence needs durable direction), but both are expressed in opaque domain jargon that makes the triggers effectively unclear. The 'Use when' clause exists but is not actionable.

2 / 3

Trigger Term Quality

The terms used ('HE cognition artifacts', 'durable direction', 'source-prompt comparison evidence') are highly specialized jargon that users would not naturally say. While 'intent', 'review', 'triage', and 'ADR' are somewhat recognizable, they are too generic and context-dependent to serve as effective trigger terms.

1 / 3

Distinctiveness Conflict Risk

The highly specialized jargon makes it unlikely to conflict with common skills, but terms like 'intent', 'review', 'triage', and 'ADR' are generic enough to potentially overlap with other skills. The niche is unclear rather than clearly defined.

2 / 3

Total

6

/

12

Passed

Implementation

42%

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

This skill is well-organized with strong progressive disclosure and clear routing to reference materials, but it suffers significantly from lack of actionability—there are no concrete examples, templates, or executable artifacts showing what a strategy output actually looks like. The workflow is sequenced but lacks concrete validation criteria and feedback loops. The content reads more like a governance policy than an actionable skill Claude can execute.

Suggestions

Add at least one complete example showing an input scenario and the corresponding output artifact (even abbreviated), including the required fields like schema_version, confidence, authority limits, and validation outcomes.

Make the Procedure steps concrete: for step 2, show the actual command or file-read pattern to resolve he-strategy in routing-map.json; for step 10, show what a pass/fail/blocked gate record looks like.

Add explicit trigger criteria for the 'Do Not Create' decision—currently it says 'low-value governance' but doesn't define what qualifies, making it unactionable.

Include a minimal artifact template (even as a skeleton) showing the required output format fields so Claude doesn't have to infer structure from the referenced contract file alone.

DimensionReasoningScore

Conciseness

The skill is moderately efficient but includes several sections that feel verbose or redundant for Claude (e.g., the Philosophy section restates what the skill already implies, and some constraints/boundaries overlap). Phrases like 'cognition compression, not ceremony' are stylistic but don't add actionable value. However, it avoids explaining basic concepts and most sections carry meaningful content.

2 / 3

Actionability

The skill is almost entirely abstract and procedural in tone with no concrete code, commands, file templates, or copy-paste-ready examples. Steps like 'Resolve he-strategy in routing-map.json' and 'Apply source-prompt, first-principles contract' give no executable detail. The Examples section lists user prompts but provides no corresponding output examples or artifact templates.

1 / 3

Workflow Clarity

The 10-step Procedure provides a numbered sequence, and there is a Validation section with named gates. However, validation checkpoints are vague ('validate the artifact against the selected mode contract'), there are no concrete feedback loops showing what to do when a gate fails beyond 'rerun failed gates', and the relationship between steps is implicit rather than explicit. The 'Do Not Create' escape hatch is a good pattern but lacks clear trigger criteria.

2 / 3

Progressive Disclosure

The References section is well-structured with clear conditional triggers ('Read when selecting mode output', 'Read when architecture lenses apply') pointing to one-level-deep reference files. The skill body stays at overview level and routes detailed contracts, lenses, and pipelines to external files with descriptive paths. Navigation is clear and well-signaled.

3 / 3

Total

8

/

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.