monkilabs/agent-hooks
src/orchestrator/skills/agent-hooks/SKILL.md
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 executes session guard, 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
$ install --global
skillsauthnpx skillsauth add monkilabs/opencastle agent-hooksInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 19, 2026, 7:28 AM333.2s2 files scanned
SKILL.md
- name:
- agent-hooks
- description:
- 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 executes session guard, 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
Agent Lifecycle Hooks
Conventions (not auto-triggers) agents execute at specific lifecycle points. Team Lead includes hook reminders in delegation prompts; specialists follow them in their own workflow.
on-session-start → [work loop] → on-session-end
↓ ↑
on-pre-delegate → on-post-delegate
on-session-start
| # | Action |
|---|--------|
| 1 | rg -n "keyword" .opencastle/LESSONS-LEARNED.md |
| 2 | cat .opencastle/SESSION-CHECKPOINT.md (resume if exists) |
| 3 | rg -n "ERROR\|FAIL" .opencastle/AGENT-FAILURES.md \|\| true |
| 4 | cat .opencastle/agents/skill-matrix.json \| jq '.bindings' — load domain skills |
See HOOKS-REFERENCE.md for extended startup checks (approval polling, skill-matrix verification).
on-session-end
⛔ HARD GATE — See logging-mandatory. Load observability-logging for the Pre-Response Quality Gate.
| # | Action |
|---|--------|
| 1 | opencastle doctor --fix (session guard) |
| 2 | opencastle log --type session ... |
| 3 | Write .opencastle/SESSION-CHECKPOINT.md if work is incomplete |
| 4 | Flag for memory merge if 5+ new lessons |
on-pre-delegate — Team Lead only
| # | Check |
|---|-------|
| 1 | Tracker issue exists (gh issue view TAS-XX) |
| 2 | File partition clean (comm -12 <(sort agent1-files) <(sort agent2-files) = empty) |
| 3 | Upstream deps Done (gh issue view TAS-XX --json state -q '.state' = CLOSED) |
| 4 | Prompt has exact file paths + acceptance criteria |
| 5 | Prompt includes "Read LESSONS-LEARNED.md first" |
| 6 | 5+ files → load context-map skill |
All 6 must pass before runSubagent. See HOOKS-REFERENCE.md for example commands per check.
on-post-delegate — Team Lead only
| # | Action |
|---|--------|
| 1 | ⛔ opencastle log --type=delegation --issue=TAS-XX --status=complete |
| 2 | Run fast-review skill |
| 3 | pnpm lint && pnpm typecheck && pnpm test |
| 4 | gh issue view TAS-XX --json body -q '.body' — verify each AC met |
| 5 | If agent retried → verify lesson added via self-improvement |
| 6 | Move to Done or re-delegate; 3rd failure → .opencastle/AGENT-FAILURES.md |
See HOOKS-REFERENCE.md for detailed verification commands.
Anti-Patterns
| Anti-pattern | Impact | |---|---| | Batch-logging retrospectively | Loses per-task provenance | | Partial post-delegate checks | False positives — build passes but ACs fail |
Related Skills
monkilabs/validation-gates
development
VerifiedTrustedCommunity
Defines 10 sequential validation gates: secret scanning, lint/test/build checks, blast radius analysis, dependency auditing, browser testing, cache management, regression checks, smoke tests. Use when running pre-deploy validation or CI checks, CI/CD pipelines, deployment pipeline validation, pre-merge checks, continuous integration, or pull request validation.
44SKILL.mdUpdated Apr 21, 2026
monkilabs/testing-workflow
development
VerifiedTrustedCommunity
Generates test plans, writes unit/integration/E2E test files, identifies coverage gaps, flags common testing anti-patterns. Use when writing tests, creating test suites, planning test strategies, mocking dependencies, measuring code coverage, or test planning.
44SKILL.mdUpdated Apr 21, 2026
monkilabs/team-lead-reference
development
VerifiedTrustedCommunity
Provides model routing rules, validates delegation prerequisites, supplies cost tracking templates, defines dead-letter queue formats for Team Lead orchestration. Load when assigning tasks to agents, choosing model tiers, starting delegation session, running multi-agent workflow, delegating work, choosing which model to use, or assigning tasks.
44SKILL.mdUpdated Apr 21, 2026
monkilabs/session-checkpoints
testing
VerifiedTrustedCommunity
Saves, restores session state including task progress, file changes, delegation history. Use when saving progress, resuming interrupted work, picking up where you left off, or checkpointing current work.
44SKILL.mdUpdated Apr 21, 2026