CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-hooks

Four lifecycle hooks every agent runs: on-session-start scans LESSONS-LEARNED.md, resumes checkpoints; on-pre-delegate verifies tracker issues, file partitions; on-post-delegate runs fast-review, CI checks; on-session-end runs the health checks, writes logs. Use when starting a new session, running pre-flight checks before delegation, coordinating between agents, reviewing a completed handoff, or wrapping up a session. Trigger terms: multi-agent setup, delegate tasks, agent coordination, session management, run pre-flight checks, start a new session, coordinate between agents, wrap up session

70

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

85%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 lean, well-sequenced hook spec with genuine validation gates and feedback loops — the workflow engineering is excellent. However, all three references point to a HOOKS-REFERENCE.md that does not exist in the bundle, and markdown-escaped pipes corrupt several copy-paste commands in the on-session-start table.

Suggestions

Ship HOOKS-REFERENCE.md in the skill bundle (or inline the extended startup checks and per-check example commands) — the body points to it three times but the file does not exist, so readers hit a dead end when they need the detailed commands.

Fix the pipe escaping in the on-session-start table: `rg -n "ERROR\|FAIL" .opencastle/AGENT-FAILURES.md \|\| true` renders with literal backslashes when copied. Move commands out of tables into fenced code blocks, or restructure the table so pipes don't need escaping.

Replace the `opencastle log --type session ...` ellipsis with one complete, realistic invocation (including the fields the Pre-Response Quality Gate expects) so the logging command is copy-paste ready.

DimensionReasoningScore

Conciseness

The body is tables of bare commands with no concept explanations, no padding, and no restating of things Claude already knows ("Conventions (not auto-triggers) agents execute at specific lifecycle points" is the only prose). Every token earns its place — the 5 anchor.

5 / 5

Actionability

Mostly concrete, executable commands (`rg -n "keyword" .opencastle/LESSONS-LEARNED.md`, `opencastle doctor`, `gh issue view TAS-XX --json body -q '.body'`), but three gaps keep it from 5: pipes in table cells are markdown-escaped (`rg -n "ERROR\|FAIL" ... \|\| true`) so the commands are corrupted when copied, `opencastle log --type session ...` trails off with a literal ellipsis, and "keyword"/"TAS-XX" placeholders are unexplained. This is the 4 anchor (concrete commands, minor gaps) rather than 3 because the commands are real, not pseudocode — the defects are fixable transcription artifacts.

4 / 5

Workflow Clarity

The lifecycle is explicitly sequenced with an ASCII diagram, on-pre-delegate has a hard gate ("All 6 must pass before the sub-agent is dispatched"), and on-post-delegate has verification with an error-recovery loop ("Move to Done or re-delegate; 3rd failure → .opencastle/AGENT-FAILURES.md") plus per-AC verification. Clear sequence, explicit validation steps, feedback loops, and checklists — the 5 anchor; validation is present throughout, so the missing-validation cap does not apply.

5 / 5

Progressive Disclosure

The body cites "See [HOOKS-REFERENCE.md](HOOKS-REFERENCE.md)" three times for extended startup checks, example commands per check, and detailed verification commands — but no bundle directory exists and HOOKS-REFERENCE.md is nowhere in the skill, so the promised detail layer is missing entirely and navigation dead-ends exactly where a reader needs the extended commands. References are clearly signaled (4-anchor trait) but broken, and the body (~74 lines) exceeds the under-50-line simple-skill exception, so it cannot score 5 on sections alone.

3 / 5

Total

17

/

20

Passed

Description

88%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: it states what each of the four hooks does with concrete actions, gives an explicit when-clause and a natural trigger-term list. The only soft spots are a few missing natural synonyms (handoff, sub-agent phrasings) and slight overlap risk on broad terms like "session management".

DimensionReasoningScore

Specificity

The description enumerates concrete actions for all four hooks — "scans LESSONS-LEARNED.md, resumes checkpoints", "verifies tracker issues, file partitions", "runs fast-review, CI checks", "runs the health checks, writes logs" — giving multiple specific actions with comprehensive coverage across the domain. This matches the 5 anchor (multiple specific concrete actions, comprehensive); it is not the 4 anchor because the gaps are only in phrasing abbreviation, not missing coverage.

5 / 5

Completeness

It explicitly answers both questions: "what" is the four named hooks with their actions, and "when" is the concrete "Use when starting a new session, running pre-flight checks before delegation, coordinating between agents, reviewing a completed handoff, or wrapping up a session" clause backed by trigger terms. This matches the 5 anchor; a missing or weak when-clause would cap it at 3, but the when-guidance here is explicit and specific.

5 / 5

Trigger Term Quality

The explicit trigger list ("multi-agent setup, delegate tasks, agent coordination, session management, run pre-flight checks, start a new session, coordinate between agents, wrap up session") plus the when-clauses gives good natural-phrase coverage. A few natural variations users would say are missing (e.g. "handoff", "spawn/dispatch sub-agents", "task delegation"), so it sits at the 4 anchor rather than the comprehensive synonym coverage of 5.

4 / 5

Distinctiveness Conflict Risk

The multi-agent lifecycle-hook niche ("on-pre-delegate verifies tracker issues, file partitions") is well-distinguished from generic skills, but broad terms like "session management" and "agent coordination" carry minor overlap risk with other agent-orchestration or session-persistence skills. Mostly distinct with minor overlap — the 4 anchor.

4 / 5

Total

18

/

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

relative_links

Relative link issues: 3 missing

Warning

Total

15

/

16

Passed

Repository
monkilabs/opencastle
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.