Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Tencent SkillHub ยท Developer Tools
Sub-Agent Overseer
Monitor sub-agent health and progress via a pull-based bash daemon. Use when spawning sub-agents that need progress tracking, staleness detection, and automa...
skill openclawclawhub Free
Monitor sub-agent health and progress via a pull-based bash daemon. Use when spawning sub-agents that need progress tracking, staleness detection, and automa...
โฌ 0 downloads โ
0 stars Unverified but indexed
Install for OpenClaw
Known item issue.
This item's current download entry is known to bounce back to a listing or homepage instead of returning a package file.
Quick setup
- Open the source page and confirm the package flow manually.
- Review SKILL.md if you can obtain the files.
- Treat this source as manual setup until the download is verified.
Package facts
- Download mode
- Manual review
- Package format
- ZIP package
- Source platform
- Tencent SkillHub
- What's included
- SKILL.md, scripts/overseer.sh
Validation
- Open the source listing and confirm there is a real package or setup artifact available.
- Review SKILL.md before asking your agent to continue.
- Treat this source as manual setup until the upstream download flow is fixed.
Install with your agent
Agent handoff
Use the source page and any available docs to guide the install because the item currently does not return a direct package file.
- Open the source page via Open source listing.
- If you can obtain the package, extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the source page and extracted files.
New install
I tried to install a skill package from Yavira, but the item currently does not return a direct package file. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required.
Upgrade existing
I tried to upgrade a skill package from Yavira, but the item currently does not return a direct package file. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need.
Trust & source
Release facts
- Source
- Tencent SkillHub
- Verification
- Indexed source record
- Version
- 1.1.0
Provenance
- Publisher
- globalcaos
- Source page
- View original listing
- Canonical URL
- Open canonical page
Documentation
Sub-Agent Overseer
Lightweight pull-based daemon that monitors sub-agent health. Writes a status file every N seconds. The heartbeat handler reads it โ no push, no noise.
Architecture
overseer.sh (bash, runs in background) โโโ /proc/<pid> โ gateway alive? CPU? threads? โโโ openclaw sessions list โ sub-agent count + ages โโโ find -newer marker โ filesystem activity โโโ writes /tmp/overseer/status.json (atomic mv) heartbeat (agent, every 3min) โโโ reads /tmp/overseer/status.json โ summarize or HEARTBEAT_OK Key principle: The overseer does all data collection. The heartbeat handler does zero tool calls if the status file is fresh and healthy.
1. Start the overseer when spawning sub-agents
setsid scripts/overseer.sh \ --workdir /path/to/repo \ --interval 180 \ --max-stale 4 \ --voice \ &>/dev/null &
2. Heartbeat reads the status file
cat /tmp/overseer/status.json
3. Interpret the status
FieldMeaningsubagents.countActive sub-agent sessionssubagents.details[].staleConsecutive cycles with no filesystem changessubagents.details[].statusactive / idle / warning / stuckgateway.health.aliveIs openclaw-gateway running?filesystem.changes_since_lastFiles modified since last check
4. Staleness thresholds (at 180s interval)
stale countTimeStatusAction0-10-3 minactive/idleNormal2-36-9 minwarningVoice alert (if --voice)โฅ4โฅ12 minstuckAgent should investigate/kill
Heartbeat Handler Protocol
When HEARTBEAT.md fires: Read /tmp/overseer/status.json โ if missing or stale (>10 min), restart overseer If subagents.count == 0 for 2+ cycles โ overseer auto-exits โ reply HEARTBEAT_OK If all agents active โ brief one-line status โ HEARTBEAT_OK If any stuck โ report which labels are stuck โ consider killing via subagents kill Never cache a previous heartbeat response. Always read the status file fresh.
Flags
FlagDefaultDescription--interval180Seconds between checks--workdircwdDirectory to watch for file changes--labels(all)Comma-separated labels to filter--max-stale4Cycles before marking stuck--voiceoffLocal TTS alerts via jarvis command
How It Works (No AI Tokens)
Gateway health: Reads /proc/<pid>/status for CPU, memory, threads, FD count. Pure kernel data. Sub-agent list: Single openclaw sessions list call per cycle. Parses grep output. Filesystem diff: find -newer marker โ detects any file writes in the workdir. Status file: JSON written atomically (write to temp, mv into place). Any reader sees a complete file. Self-exit: If no sub-agents for 2 consecutive cycles, the overseer stops itself. Dedup: flock ensures only one overseer instance runs at a time.
Cost
Overseer: $0.00 (bash + /proc + one CLI call per cycle) Voice alerts: $0.00 (local sherpa-onnx via jarvis) Heartbeat reads status file: $0.00 (one cat command) Only cost is the heartbeat model itself (qwen3 local = free)
Pairs Well With
agent-superpowers โ the three-agent review pipeline that Overseer was built to monitor smart-model-router โ auto-select models for each sub-agent role ๐ https://github.com/globalcaos/tinkerclaw Clone it. Fork it. Break it. Make it yours.
Category context
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Source: Tencent SkillHub
Largest current source with strong distribution and engagement signals.
Package contents
Included in package
1 Docs1 Scripts
- SKILL.md
- scripts/overseer.sh