CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

he-phase-work

Runs approved Harness Engineering plans in recurring phases: check live state, confirm continuation authority, execute only the active he-work slice, verify gates, update Linear only with approval, and stop before unsafe staging or closure. Use when a plan, issue, or PR needs continued phase-by-phase execution.

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

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

A well-structured orchestration skill: the phase workflow is clearly sequenced with explicit validation, feedback loops, and stop conditions, and delegation/output examples are concrete. Weaknesses are mild redundancy in the stop-condition material, a boilerplate context-disposition paragraph, and a References section that undersignals which file to read when — including paths that escape the bundle.

Suggestions

Consolidate the overlapping stop conditions in Validation, Failure Mode, and Constraints into one authoritative stop-rule section to save tokens.

Annotate each References entry with a one-line 'read when' trigger (as phase-gate-contract.md does internally) so navigation is self-explanatory, and verify the ../../references/ paths actually resolve from the installed skill location.

Drop or rewrite the 'context-disposition policy' paragraph in the Procedure — it reads as generic boilerplate rather than executable guidance for this skill.

DimensionReasoningScore

Conciseness

The body is dense and assumes competence — no concept explanations, just commands, contracts, and stop rules — earning above the score-3 anchor. It falls short of score 5 because stop conditions are restated across Validation, Failure Mode, and Constraints, and the 'context-disposition policy' paragraph in the Procedure reads as boilerplate padding that adds tokens without actionable value.

4 / 5

Actionability

The Validation block gives concrete commands (git status --short, test -f, rg, ./bin/ask ... --json --robot), and the Delegation Examples and Output Template are copy-paste ready. Not score 5 because some steps remain abstract ('Refresh dashboards/browser', 'confirm continuation authority') without commands, and the validation commands carry unresolved placeholders like <approved-plan-path>.

4 / 5

Workflow Clarity

The Procedure is a clearly ordered 1–7 sequence with an explicit validation step, a fail-fast rule ('stop at the first failed gate'), and an error-recovery feedback loop (route failures to he-work or he-code-review with the exact command and output). This matches the score-5 anchor: explicit validation steps, feedback loops, and defined stop conditions.

5 / 5

Progressive Disclosure

The SKILL.md stays an overview with detail pushed to one-level-deep bundle files (references/phase-gate-contract.md, references/contract.yaml, references/evals.yaml — all verified present). Not score 5 because the References section is a terse bare list with minimal signaling of when each file should be read, and three referenced paths (../../references/stage-arc-boundary-contract.md, subagent-call-contract.md, deferred-context-index.md) point outside the skill bundle and could not be verified to resolve.

4 / 5

Total

17

/

20

Passed

Description

76%Weight 40%Scale 1-5

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

A strong description that is specific, comprehensive, and distinct, with an explicit 'Use when...' clause. Its main weakness is trigger phrasing that leans on internal jargon and abstract conditions rather than the words a user would naturally say when asking for continued phase execution.

Suggestions

Rewrite the 'when' clause around concrete user utterances, e.g. 'Use when the user says continue the plan, run the next phase, or keep this PR/issue moving.'

Add natural synonyms or shorthand (e.g. 'run phases', 'continue implementation', 'phase gate') to the trigger surface so it matches how users actually phrase the request.

Soften internal jargon such as 'Harness Engineering plans' with a plain-language gloss so the description still triggers for users who don't know the HE terminology.

DimensionReasoningScore

Specificity

The description enumerates six concrete actions — "check live state, confirm continuation authority, execute only the active he-work slice, verify gates, update Linear only with approval, and stop before unsafe staging or closure" — comprehensively covering the skill's behavior. It exceeds the score-4 anchor ('lists several specific actions; minor gaps') because every phase of the loop (check, authorize, execute, verify, report, halt) is explicitly named.

5 / 5

Completeness

Both are answered: what ("Runs approved Harness Engineering plans in recurring phases...") and when ("Use when a plan, issue, or PR needs continued phase-by-phase execution"). Not score 5 because the 'when' clause states an abstract condition rather than concrete user trigger phrases (compare the score-5 example 'when the user mentions PDFs, forms, or document extraction').

4 / 5

Trigger Term Quality

Keywords like "plan, issue, or PR" and "phase-by-phase execution" are relevant, but natural user phrasings such as "continue the plan", "keep this PR moving", or "run the next phase" are absent, and terms like "Harness Engineering plans" are internal jargon. This matches the score-3 anchor (relevant keywords missing common variations/synonyms) rather than score 4, which expects broader natural-term coverage.

3 / 5

Distinctiveness Conflict Risk

It carves out a clear niche — recurring, gated execution of an already-approved plan — that is clearly distinguishable from one-off implementation skills, and the explicit 'approved' and 'phase-by-phase' qualifiers minimize wrong-skill triggers. Fits the score-5 anchor (clear niche with distinct triggers; minimal conflict risk).

5 / 5

Total

17

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

jscraik/Agent-Skills

Path

Plugins/harness-engineering/skills/he-phase-work/SKILL.md

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.