leek/agent-skills / skills/harness-tools
harness-tools
VerifiedThe tool each agent harness (Claude Code, Codex, Grok, agy) uses to start, follow up with, or stop a sub-agent, and to ask the user a structured question. Use when a skill names one of these moves and points here, or when you are not sure which tool your harness has for it.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.6 KB |
| agents/openai.yaml | config | 245 B |
| scripts/test-wait-task-output.shexecutable | script | 2.6 KB |
| scripts/wait-task-output.shexecutable | script | 2.0 KB |
scripts/test-wait-task-output.sh
View on GitHub#!/bin/bash
# Offline test for wait-task-output.sh with a 1-second poll.
# Usage: test-wait-task-output.sh (prints one "ok <case>" line per case; exits 1 on the first failure)
set -e
here=$(cd "$(dirname "$0")" && pwd)
script="$here/wait-task-output.sh"
T=$(mktemp -d)
trap 'rm -rf "$T"' EXIT
export WAIT_TASK_POLL_SECONDS=1
fail() { echo "FAIL $1" >&2; [ ! -f "$T/err" ] || sed 's/^/ stderr: /' "$T/err" >&2; exit 1; }
eq() { [ "$2" = "$3" ] || fail "$1: got '$2', want '$3'"; }
# finished before the call: returns at once with the exit code
printf 'line\n{"tool":"pest","result":"failed"}\n\n[exited with code 2]\n' > "$T/done.output"
out=$(bash "$script" "$T/done.output" 5 2>"$T/err") || fail "done: exit $?"
eq "done status" "$(printf '%s' "$out" | jq -r .status)" done
eq "done code" "$(printf '%s' "$out" | jq -r .exit_code)" 2
echo "ok finished task returns its exit code"
# finishes while waiting: returns once the marker lands, before max-seconds
printf 'running\n' > "$T/late.output"
( sleep 2; printf '\n[exited with code 0]\n' >> "$T/late.output" ) &
start=$(date +%s)
out=$(bash "$script" "$T/late.output" 20 2>"$T/err") || fail "late: exit $?"
wait
eq "late status" "$(printf '%s' "$out" | jq -r .status)" done
eq "late code" "$(printf '%s' "$out" | jq -r .exit_code)" 0
[ $(( $(date +%s) - start )) -lt 10 ] || fail "late: did not return when the marker landed"
echo "ok task finishing mid-wait returns promptly"
# killed task
printf 'output\n\n[killed]\n' > "$T/killed.output"
out=$(bash "$script" "$T/killed.output" 5 2>"$T/err") || fail "killed: exit $?"
eq "killed status" "$(printf '%s' "$out" | jq -r .status)" killed
echo "ok killed task reports killed"
# a line that only mentions the marker mid-text does not count
printf 'echo "[exited with code 0]" in a log line\n' > "$T/mention.output"
out=$(bash "$script" "$T/mention.output" 2 2>"$T/err") || fail "mention: exit $?"
eq "mention status" "$(printf '%s' "$out" | jq -r .status)" running
echo "ok marker must be its own line"
# still running at max-seconds: reports running so the caller waits again
printf 'running\n' > "$T/slow.output"
out=$(bash "$script" "$T/slow.output" 2 2>"$T/err") || fail "slow: exit $?"
eq "slow status" "$(printf '%s' "$out" | jq -r .status)" running
[ "$(printf '%s' "$out" | jq -r .waited)" -ge 2 ] || fail "slow: waited less than max-seconds"
echo "ok still-running task reports running at max-seconds"
# bad input exits 1
if bash "$script" "$T/missing.output" 2>"$T/err"; then fail "missing file accepted"; fi
if bash "$script" "$T/done.output" 9x 2>"$T/err"; then fail "bad max-seconds accepted"; fi
echo "ok bad input exits 1"
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |