Hermes ephemeral delegation skill

Trigger: broad exploration, multi-file reads, tests/builds, fresh review, or multi-step debug.

by Gentleman-Programming·MIT license·★ 7,519 Stars on the repo·GitHub ↗

Use now

Files of Hermes ephemeral delegation

Gentleman-Programming/main1 file shown
SKILL.md
Show the full text71 lines
hermes-ephemeral-delegation/SKILL.md71 lines · 3.3 KB

Activation Contract

Load this skill when you are acting as the parent orchestrator and the work ahead falls into any of these categories:

  • Broad exploration (4+ files to understand, codebase mapping, approach comparison)
  • A large (tracked) task: its resume test fails, so one writer per task
  • A high-risk change that needs an independent verifier, or a large task's long suites and builds
  • Fresh adversarial review (diffs, PR readiness, incident audit)
  • Multi-step debugging that would flood the parent context

Do NOT load this skill if you are already inside a delegated child task — you are the executor, not the orchestrator.

Hard Rules

  • Use delegate_task for all complex work listed above. Do NOT execute it inline.
  • Workers are EPHEMERAL: each delegate_task call creates a fresh context. Do NOT request persistent agent files or profiles.
  • Pass a self-contained mission. Workers have no memory of the parent conversation.
  • Treat worker output as self-report: verify file writes, test pass/fail, URLs, and IDs before reporting success to the user.
  • Batch parallel calls only for INDEPENDENT workstreams. Sequential dependencies must run sequentially.

Decision Gates

Situation Action
Need to read 4+ files to understand Delegate a narrow exploration worker
A large (tracked) task Delegate a single writer per task with the full mission
A small task's focused test and suite Run inline, once each
A high-risk change or a large task's long suites Delegate an executor
Need an adversarial review of a diff Delegate a fresh-context reviewer
Multi-step debug that grows the context Delegate a debug worker; feed results back inline
Simple 1-file edit you already understand Do it inline; no delegation needed
Quick git/state check Do it inline; no delegation needed

Execution Steps

  1. Identify which gate applies. If none applies, skip delegation.
  2. Draft a self-contained mission for the worker — include:
    • Exact goal (one sentence)
    • File paths or targets to act on
    • Relevant prior context the worker needs (decisions, conventions, prior findings)
    • Constraints (style, test runner, budget)
    • Expected evidence to return (e.g., file written, test output, URL found)
    • Allowed toolsets/MCP/skills the worker should use
    • Any SKILL.md paths to load before work
  3. Call delegate_task with that mission.
  4. Wait for the worker summary.
  5. Verify the claimed output (check file existence, test result, side effect).
  6. Synthesize the verified result into your orchestrator reply.

Output Contract

After synthesizing worker results, return:

  • What was delegated and to how many workers
  • What each worker returned (verified, not just claimed)
  • Any discrepancy between worker self-report and verified evidence
  • Final answer or next step for the user

References

  • references/tuning-knobs.md — Full table of delegate_task configuration parameters and the explicit toolset/MCP/skill checklist for worker missions.
1---
2name: hermes-ephemeral-delegation
3description: "Trigger: broad exploration, multi-file reads, tests/builds, fresh review, or multi-step debug. Orchestrate complex work via delegate_task to protect context."
4license: Apache-2.0
5metadata:
6 author: gentleman-programming
7 version: "1.0"
8---
9 
10## Activation Contract
11 
12Load this skill when you are acting as the parent orchestrator and the work ahead falls into any of these categories:
13 
14- Broad exploration (4+ files to understand, codebase mapping, approach comparison)
15- A large (tracked) task: its resume test fails, so one writer per task
16- A high-risk change that needs an independent verifier, or a large task's long suites and builds
17- Fresh adversarial review (diffs, PR readiness, incident audit)
18- Multi-step debugging that would flood the parent context
19 
20Do NOT load this skill if you are already inside a delegated child task — you are the executor, not the orchestrator.
21 
22## Hard Rules
23 
24- Use `delegate_task` for all complex work listed above. Do NOT execute it inline.
25- Workers are EPHEMERAL: each `delegate_task` call creates a fresh context. Do NOT request persistent agent files or profiles.
26- Pass a self-contained mission. Workers have no memory of the parent conversation.
27- Treat worker output as self-report: verify file writes, test pass/fail, URLs, and IDs before reporting success to the user.
28- Batch parallel calls only for INDEPENDENT workstreams. Sequential dependencies must run sequentially.
29 
30## Decision Gates
31 
32| Situation | Action |
33|-----------|--------|
34| Need to read 4+ files to understand | Delegate a narrow exploration worker |
35| A large (tracked) task | Delegate a single writer per task with the full mission |
36| A small task's focused test and suite | Run inline, once each |
37| A high-risk change or a large task's long suites | Delegate an executor |
38| Need an adversarial review of a diff | Delegate a fresh-context reviewer |
39| Multi-step debug that grows the context | Delegate a debug worker; feed results back inline |
40| Simple 1-file edit you already understand | Do it inline; no delegation needed |
41| Quick git/state check | Do it inline; no delegation needed |
42 
43## Execution Steps
44 
451. Identify which gate applies. If none applies, skip delegation.
462. Draft a self-contained mission for the worker — include:
47 - Exact goal (one sentence)
48 - File paths or targets to act on
49 - Relevant prior context the worker needs (decisions, conventions, prior findings)
50 - Constraints (style, test runner, budget)
51 - Expected evidence to return (e.g., file written, test output, URL found)
52 - Allowed toolsets/MCP/skills the worker should use
53 - Any `SKILL.md` paths to load before work
543. Call `delegate_task` with that mission.
554. Wait for the worker summary.
565. Verify the claimed output (check file existence, test result, side effect).
576. Synthesize the verified result into your orchestrator reply.
58 
59## Output Contract
60 
61After synthesizing worker results, return:
62 
63- What was delegated and to how many workers
64- What each worker returned (verified, not just claimed)
65- Any discrepancy between worker self-report and verified evidence
66- Final answer or next step for the user
67 
68## References
69 
70- [references/tuning-knobs.md](references/tuning-knobs.md) — Full table of `delegate_task` configuration parameters and the explicit toolset/MCP/skill checklist for worker missions.
71 

Discussion