ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

project-manager-agent

Monitors active sub-agents, detects stalls, provides status updates, and steers stuck agents via sessions_send.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/austindixson/project-manager-agent
Or

Project Manager Agent

Description

Monitors active sub-agents, detects stalls, provides status updates, and steers stuck agents via sessions_send.

Project Manager Agent

This skill provides oversight for your OpenClaw sub-agents. It proactively checks the status of running sub-agents, identifies potential stalls or failures, and can steer stalled sub-agents by sending a continue message via the sessions_send tool.

Usage

Running the monitor

python3 <skill-dir>/scripts/project_manager.py

Options

  • --staleness_threshold_minutes <int>: Minutes after which a sub-agent is considered stalled (default from config or 10).
  • --check_all_sessions: Check all sessions, not just subagents of the current main session.
  • --json: Print human summary then a JSON line with stalledSessionKeys, steerMessage, and summary for agent steering.
  • --no_cooldown: Output all stalled keys (ignore 15-minute cooldown).
  • --record-steered KEY [KEY ...]: Record these session keys as just steered (for cooldown). Run after calling sessions_send.

Example (Status check, human-only)

python3 /Users/ghost/.openclaw/workspace/skills/project-manager-agent/scripts/project_manager.py --staleness_threshold_minutes 15

Example (Agent run with steering)

python3 /Users/ghost/.openclaw/workspace/skills/project-manager-agent/scripts/project_manager.py --json --staleness_threshold_minutes 10

Then parse the last line (JSON), call sessions_send for each key in stalledSessionKeys, and optionally run --record-steered <keys>.

Features

  • Sub-agent Monitoring: Lists all active sub-agents (file-based; no gateway API in the script).
  • Stall Detection: Flags sub-agents that haven't updated their status within a configurable time period.
  • Failure Identification: Reports on sub-agents that have aborted their last run.
  • Status Reports: Human-readable summaries and optional JSON with stalledSessionKeys for steering.
  • Automated Steering: When you run the skill with --json, parse the output and call sessions_send for each stalled session (see Agent instructions below).

Agent instructions (mandatory when running this skill)

When the user or a cron asks you to run the project-manager-agent skill:

Metadata

Stars4473
Views0
Updated2026-05-01
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-austindixson-project-manager-agent": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.