CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

he-phase-heartbeat

Routes old phase-heartbeat requests into HE phase work: check the approved plan, reuse or create a 10-minute continuation only with authority, run phase gates, delegate the active slice to he-work, and stop before commit or tracker closure. Use when a user says phase heartbeat, keep this PR moving, or continue phases.

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./Plugins/harness-engineering/skills/he-phase-heartbeat/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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.

The body is a well-structured routing procedure with strong workflow sequencing, explicit validation gates, and a concrete output template. Its weaknesses are repeated restatement of the same safety boundary across many sections and a reference structure where half the cited paths do not resolve and one bundle file is orphaned.

Suggestions

Consolidate the overlapping safety restatements in Philosophy, Execution Boundaries, Failure Mode, Gotchas, and Validation Gates into a single authoritative 'stop boundaries' section to reduce token cost without losing coverage.

Fix the reference structure: either ensure ../../references/stage-arc-boundary-contract.md, ../../references/subagent-call-contract.md, and ../../references/deferred-context-index.md exist at the cited paths, or inline the essential rules they carry; also reference or remove the orphaned references/task-profile.json.

Add one line of inline substance for each named contract invoked by the procedure (phase gate contract, context-disposition policy, stage arc boundary) so the skill remains actionable when the referenced files are unavailable.

DimensionReasoningScore

Conciseness

The body is mostly efficient and free of padding, but the stop-before-commit/authority rule is restated across Philosophy ("does not authorize implementation, staging, commits, Linear updates, or closure"), Procedure step 6, Execution Boundaries, Failure Mode, Gotchas, and Validation Gates. Consolidating these overlapping safety restatements would tighten the document noticeably.

3 / 5

Actionability

The numbered procedure, exact output field names (slack_policy, stop_rule_status, next_safe_action), and a fully filled Output Template with an exact command ("bash scripts/verify-work.sh --fast") give mostly executable guidance. Minor gaps remain where steps defer to named contracts ("run the phase gate contract", "apply the context-disposition policy") without any inline summary of what those entail.

4 / 5

Workflow Clarity

The 6-step procedure is clearly sequenced, the fail-fast rule ("stop at the first failed gate and do not proceed until the blocker is fixed") provides an explicit feedback loop, and Validation Gates plus the Failure Mode recovery step form a checklist with error recovery. Validation for the risky operations is explicitly present, so the destructive-operation cap does not apply.

5 / 5

Progressive Disclosure

The References section is clearly signaled and one level deep, and references/phase-gate-contract.md, references/contract.yaml, and references/evals.yaml exist in the bundle. However, three referenced paths (../../references/stage-arc-boundary-contract.md, ../../references/subagent-call-contract.md, ../../references/deferred-context-index.md) do not resolve in the bundle, and references/task-profile.json is present but never referenced, leaving organization gaps beyond the minor ones allowed at level 4.

3 / 5

Total

15

/

20

Passed

Description

83%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 explicitly states what the skill does, when to use it, and concrete user trigger phrases. Its main weakness is reliance on internal ecosystem jargon (HE phase work, he-work, tracker closure) that limits how concrete and self-contained the capability list reads.

DimensionReasoningScore

Specificity

The description lists several concrete routing actions ("check the approved plan, reuse or create a 10-minute continuation only with authority, run phase gates, delegate the active slice to he-work, and stop before commit or tracker closure"), but terms like "HE phase work" and "he-work" are unresolved internal jargon that leaves minor gaps in coverage. It is above level 3 because it names the domain plus five specific actions, but below level 5 because comprehensiveness is diluted by jargon a reader cannot decode.

4 / 5

Completeness

It explicitly answers both "what" (routes old phase-heartbeat requests into HE phase work with enumerated actions) and "when" (three concrete user trigger phrases). It clearly matches the level 5 anchor rather than level 4, since the when clause is explicit and specific rather than weakly implied.

5 / 5

Trigger Term Quality

"Use when a user says phase heartbeat, keep this PR moving, or continue phases" provides natural phrases a user would actually say. Good coverage, but common variations such as "recurring phase work", "heartbeat loop", or "10 minute continuation" are missing, keeping it just below comprehensive.

4 / 5

Distinctiveness Conflict Risk

Triggers like "phase heartbeat" carve a fairly distinct niche, but the skill family it belongs to (he-work, he-plan, he-spec, he-phase-work) shares trigger space around "continue phases" and phase continuation requests, creating minor overlap risk with closely related skills.

4 / 5

Total

17

/

20

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

jscraik/Agent-Skills

Path

Plugins/harness-engineering/skills/he-phase-heartbeat/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.