agent-hooks
Four lifecycle hooks every agent runs: on-session-start scans LESSONS-LEARNED.md and resumes checkpoints, on-pre-delegate verifies tracker issues and file partitions, on-post-delegate runs fast-review and CI checks, on-session-end executes the session guard and 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
100
100%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%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 is a strong skill description that clearly articulates four specific lifecycle hooks with concrete actions, provides explicit 'Use when' guidance, and includes a well-curated list of trigger terms. The description is specific to multi-agent coordination and session management, making it highly distinguishable from other skills. It uses proper third-person voice throughout.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions across four lifecycle hooks: scanning LESSONS-LEARNED.md, resuming checkpoints, verifying tracker issues and file partitions, running fast-review and CI checks, executing session guard, and writing logs. | 3 / 3 |
Completeness | Clearly answers both 'what' (four lifecycle hooks with specific actions for each) and 'when' (explicit 'Use when...' clause covering starting sessions, pre-flight checks, delegation coordination, reviewing handoffs, and wrapping up). Both are well-articulated. | 3 / 3 |
Trigger Term Quality | Includes a comprehensive set of natural trigger terms that users would actually say: 'multi-agent setup', 'delegate tasks', 'agent coordination', 'session management', 'run pre-flight checks', 'start a new session', 'coordinate between agents', 'wrap up session'. These cover common variations well. | 3 / 3 |
Distinctiveness Conflict Risk | Targets a very specific niche of multi-agent lifecycle management with distinct concepts like lifecycle hooks, session guards, LESSONS-LEARNED.md, and delegation verification. Unlikely to conflict with other skills due to the specialized domain of agent coordination and session management. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an excellent skill file that efficiently communicates four distinct lifecycle hooks with concrete commands, clear sequencing, and explicit validation gates. The use of tables keeps each hook scannable, the ASCII diagram provides immediate orientation, and references to HOOKS-REFERENCE.md appropriately offload detailed examples. The anti-patterns section adds value without bloat.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line serves a purpose — no explanations of what hooks are, no padding about why lifecycle management matters. Tables are tight, commands are specific, and the ASCII diagram is minimal yet informative. | 3 / 3 |
Actionability | Each hook provides concrete, executable commands (rg, gh, jq, opencastle CLI, pnpm). The pre-delegate checklist has specific verification commands with expected outputs (e.g., '= empty', '= CLOSED'). Copy-paste ready. | 3 / 3 |
Workflow Clarity | Clear sequencing via numbered tables for each lifecycle phase, with explicit gates (⛔ HARD GATE on session-end logging, all 6 checks must pass before runSubagent). Error recovery is addressed (3rd failure → AGENT-FAILURES.md, re-delegate path). The ASCII flow diagram at the top orients the reader immediately. | 3 / 3 |
Progressive Disclosure | Overview stays concise with well-signaled one-level-deep references to HOOKS-REFERENCE.md for extended checks and example commands, plus a snippet reference for the logging gate. Content is appropriately split — the skill body covers what to do, references cover how in detail. | 3 / 3 |
Total | 12 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- monkilabs/opencastle
- Commit
18c6f2c
- 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.