Agent skill

ClawSweeper Status

by steipete in steipete/agent-scripts

Reports ClawSweeper's status with a bundled script: workflow health, active workers, queue health and recently merged, reviewed, commented and closed items.

MITAuto-check passedDevOps & Cloud

Install ClawSweeper Status

skills CLI
$ npx skills add steipete/agent-scripts --skill clawsweeper-status -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install steipete/agent-scripts clawsweeper-status --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/steipete/agent-scripts.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/clawsweeper-status .claude/skills/clawsweeper-status && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
clawsweeper-status
GitHub stars
7.3k
Token cost
~972 tokens
SKILL.md length
433 words
Files
5 (incl. scripts)
Skills in repo
45
Repo updated
First seen
Licence
MIT

At a glance

Reports ClawSweeper's status with a bundled script: workflow health, active workers, queue health and recently merged, reviewed, commented and closed items.

  • Checking whether ClawSweeper workflows are healthy
  • SKILL.md covers Quick Start, Output Contract, Efficient Data Sources and Interpretation
  • Runs Shell scripts from its folder; calls gh
  • Seeing how many workers and queue items are active

What it does

The agent runs the bundled `clawsweeper-status.sh` script first, optionally with `--hours` to set the time window for the default target repository, openclaw/openclaw, and then reports in a fixed contract: Workers, Queue health, Publication tail, Recently merged, Recently reviewed, Recently commented and Recently closed. A section with no rows is reported as none found in the window.

Queue health leads the report whenever it is not healthy, and the agent reads the split printed under it instead of judging by pending depth alone. Near-zero ready items with a deep queue means items are deliberately held back, GitHub rate-limit backoff recovers on its own, and parked items that exhausted review retries do not self-heal and need an operator. Occupancy marked unavailable does not mean zero. Active workflow groups are capped at 20, required fetch failures stay fatal, and optional telemetry may be unavailable. A test script and fixture ship alongside.

When your agent uses it

  • Checking whether ClawSweeper workflows are healthy
  • Seeing how many workers and queue items are active
  • Listing recently merged, reviewed or closed items for the target repository

Example prompts

  • “Give me the ClawSweeper status for the last 10 hours.”
  • “Is the ClawSweeper review queue stalled or just holding items back?”
  • “List what ClawSweeper recently merged and closed.”

Requirements

  • The bundled `clawsweeper-status.sh` script
  • Network access for the script's API calls

What it can do on your machine

Read from SKILL.md and the folder at commit 79150cf. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • gh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use gh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

ClawSweeper Status loads about 972 tokens when it runs. Until then it costs about 23 tokens; SKILL.md has 433 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~23
When it runs · the whole SKILL.md, loaded when a task matches
~972

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from steipete/agent-scripts at commit 79150cf, republished under its MIT licence (© steipete). 433 words, ~972 tokens.

Download SKILL.mdSave it as .claude/skills/clawsweeper-status/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
clawsweeper-status
description
ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

ClawSweeper Status

Quick Start

Run the bundled status script first:

bash
/Users/steipete/Projects/agent-scripts/skills/clawsweeper-status/scripts/clawsweeper-status.sh

Useful options:

bash
# Last 10 hours for the default target repo, openclaw/openclaw
/Users/steipete/Projects/agent-scripts/skills/clawsweeper-status/scripts/clawsweeper-status.sh --hours 10

# A different target repo
/Users/steipete/Projects/agent-scripts/skills/clawsweeper-status/scripts/clawsweeper-status.sh --repo openclaw/clawhub

# More rows per activity section
/Users/steipete/Projects/agent-scripts/skills/clawsweeper-status/scripts/clawsweeper-status.sh --limit 15

Output Contract

Report these sections concisely:

  • Workers: workflow state, Codex jobs against configured capacity, exact-review queue and target occupancy when available, and active workflow groups. Public queue aggregates remain usable without private target occupancy; occupancy unavailable does not mean zero.
  • Queue health: lead with this whenever it is not healthy. Pending depth on its own is not a verdict — read the split the script prints underneath it:
    • ready/admissible near zero while pending is deep means the lane is deliberately holding items back, not stalled.
    • Queue backoff: throttle_retry N means GitHub is rate-limiting; the lane recovers on its own once quota returns.
    • Queue parked (needs operator): review_retry_exhausted N does not self-heal. Parked items retry at 5/10/20 minutes and then wait for a human. Always call these out explicitly.
    • Shed since reset climbing into the thousands means sustained overload, not a blip.
  • Publication tail: aggregate pending/ready/backoff/parked/active counts and capacity when available, plus retry and parked reasons. This is separate from the review backlog, not per-target activity; legacy responses without this lane report unavailable.
  • Recently merged: merged PR URLs plus one-line titles.
  • Recently reviewed: ClawSweeper/Codex review comment URLs plus one-line comment summary.
  • Recently commented: other recent ClawSweeper comment URLs plus one-line comment summary.
  • Recently closed: closed issue/PR URLs plus one-line titles.

If the script returns no rows for a section, say none found in window.

Active workflow groups are capped at 20, ordered by descending run count; activity sections are capped at --limit rows. Large workflow snapshots must still reach all activity sections. Required fetch/parser failures remain fatal; optional queue/capacity telemetry can remain unavailable.

Show full SKILL.md (160 more words)Show less

Efficient Data Sources

Prefer the script because it uses bounded API calls:

  • field-bounded Actions run queries and bounded active-job probes from openclaw/clawsweeper;
  • the small automation-limits config and exact-review queue status endpoint for capacity context;
  • recent issue comments for review/comment URLs;
  • a field-bounded closed-item search for close URLs and actors;
  • field-bounded recent merged PRs.

Do not browse the web for these checks. Use gh directly.

Interpretation

  • Cancelled repository-dispatch review runs are usually expected supersession when a newer event for the same item arrives.
  • Count Codex usage from actual in-progress/queued jobs; use setup-action steps plus known lane names to identify Codex work.
  • Treat pending workflow runs as concurrency waiters, not queued Codex jobs.
  • Treat stale worker counts cautiously; compare the status-filtered gh run list results with the default recent-run list when numbers disagree.
  • Queue reads stay unauthenticated. Public oldest-pending age is useful without a private item key; missing health counts remain unknown, not zero.
  • Use full GitHub URLs in the final answer.

© steipete, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (scripts) in skills/clawsweeper-status of steipete/agent-scripts.

  • SKILL.md
  • agents/openai.yaml
  • scripts/clawsweeper-status.sh
  • scripts/clawsweeper-status.test.sh
  • scripts/fixtures/public-exact-review-queue.json

Open the folder on GitHubat commit 79150cf

Compare with similar skills

ClawSweeper Status next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

ClawSweeper Status compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
ClawSweeper Status this skillsteipete/agent-scripts7.3k—~972Automated safety check: PassMIT
Autopilot Issue Delivery Workermicrosoft/apm4k—~1.7kAutomated safety check: PassMIT
Tool ConnectorZhixiangLuo/10xProductivity478—~925Automated safety check: PassMIT
Golang Samber Hotsamber/cc-skills-golang3.4k—~2kAutomated safety check: PassMIT
Admingrafana/skills281—~1.5kAutomated safety check: PassApache-2.0
Autopilot Commentmicrosoft/apm4k—~883Automated safety check: PassMIT

Similar skills

  • Official

    A skill your agent uses to implement ONE microsoft/apm issue already selected by autopilot-issue-delivery-scheduler.

    4k GitHub stars~1.7k tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed
  • Tool Connector

    ZhixiangLuo/10xProductivity

    Connect any tool you use at work to your agent — including internal company tools, custom-built systems, deployment portals, incident trackers, internal knowledge bases, HR systems, and commercial…

    478 GitHub stars~925 tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed
  • Golang Samber Hot

    samber/cc-skills-golang

    In-memory caching in Golang using samber/hot — eviction algorithms (LRU, LFU, TinyLFU, W-TinyLFU, S3FIFO, ARC, TwoQueue, SIEVE, FIFO), TTL, cache loaders, sharding, stale-while-revalidate, missing…

    3.4k GitHub stars~2k tokensUpdated 8 days ago
    DevOps & CloudAuto-check passed
  • Admin

    grafana/skills

    Official

    Manage Grafana Cloud accounts — organizations, stacks, RBAC roles and assignments, SSO/SAML/OAuth/GitHub auth, service accounts for CI/CD, user invites, team membership, and API-driven provisioning.

    281 GitHub stars~1.5k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Autopilot Comment

    microsoft/apm

    Official

    A skill your agent uses to post or patch ONE GitHub comment for a microsoft/apm autopilot run.

    4k GitHub stars~883 tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed
  • Official

    Generate a copy-paste Grafana data source provisioning file (YAML or Terraform) for any plugin from its standardized settings schema on the plugins CDN.

    281 GitHub stars~2.8k tokensUpdated yesterday
    DevOps & CloudAuto-check passed

More from steipete/agent-scripts

All 45 skills in this repo
  • Mac Fleet Maintenance

    steipete/agent-scripts

    Inventories and maintains a fleet of Macs from a desired-state file: package updates, repo and Xcode sync, and disk, backup and security health reports.

    7.3k GitHub stars~4.8k tokensUpdated 5 days ago
    Auto-check passed
  • Agent Transcript for PRs

    steipete/agent-scripts

    Finds a coding agent's session log, trims and redacts it, and inserts it into a GitHub PR or issue only when the user has asked for a transcript.

    7.3k GitHub starsUsed in 1 repo~698 tokens
    Auto-check passed
  • Parallels macOS VM Lab

    steipete/agent-scripts

    Uses a clean Parallels macOS VM to test GUI automation, TCC permission prompts and screenshot tools like Peekaboo, verifying results from outside the guest.

    7.3k GitHub stars~1.8k tokensUpdated 5 days ago
    Auto-check passed
  • GitHub Project Triage

    steipete/agent-scripts

    Produces maintainer-facing triage cards for a project's GitHub issues and pull requests, each with its URL, risk, test state, blockers and a next action.

    7.3k GitHub stars~4k tokensUpdated 5 days ago
    Auto-check passed
  • Nano Banana Image Generation

    steipete/agent-scripts

    Generates and edits images with Google's Nano Banana 2 (Gemini 3.1 Flash Image) through a uv script, with a draft-then-final workflow and sizes from 512 to 4K.

    7.3k GitHub stars~1.4k tokensUpdated 5 days ago
    Auto-check passed
  • npm Registry Operations

    steipete/agent-scripts

    Handles npm registry tasks such as whoami checks, package name availability, name reservation and publishing, with credentials pulled from 1Password.

    7.3k GitHub stars~1.1k tokensUpdated 5 days ago
    Auto-check passed

Works with

Questions about ClawSweeper Status

What does ClawSweeper Status do?

Reports ClawSweeper's status with a bundled script: workflow health, active workers, queue health and recently merged, reviewed, commented and closed items. sh` script first, optionally with `--hours` to set the time window for the default target repository, openclaw/openclaw, and then reports in a fixed contract: Workers, Queue health, Publication tail, Recently merged, Recently reviewed, Recently commented and Recently closed. A section with no rows is reported as none found in the window.

When should I use ClawSweeper Status?

ClawSweeper Status fits situations like: checking whether ClawSweeper workflows are healthy; seeing how many workers and queue items are active; listing recently merged, reviewed or closed items for the target repository.

How do I install ClawSweeper Status in Claude Code?

Run `npx skills add steipete/agent-scripts --skill clawsweeper-status -a claude-code`. Or copy the skill folder (skills/clawsweeper-status in steipete/agent-scripts) into .claude/skills/clawsweeper-status in your project. Claude Code loads it when a task matches its description.

How do I install ClawSweeper Status in Codex?

Run `npx skills add steipete/agent-scripts --skill clawsweeper-status -a codex`. Or copy the skill folder (skills/clawsweeper-status in steipete/agent-scripts) into .agents/skills/clawsweeper-status in your project. Codex loads it when a task matches its description.

Can I use ClawSweeper Status in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add steipete/agent-scripts --skill clawsweeper-status -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/clawsweeper-status, .gemini/skills/clawsweeper-status, .github/skills/clawsweeper-status and .opencode/skills/clawsweeper-status in your project.

What does ClawSweeper Status need to run?

Going by SKILL.md and its folder, ClawSweeper Status needs a shell for the scripts in its folder and the command-line tools its instructions call (gh). Our summary lists: The bundled `clawsweeper-status.sh` script; Network access for the script's API calls.

Does ClawSweeper Status access the network?

SKILL.md contains no URLs. Its commands use gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is ClawSweeper Status safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does ClawSweeper Status use?

ClawSweeper Status is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does ClawSweeper Status use?

About 972 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to ClawSweeper Status?

Skills that share tags, products or a category with ClawSweeper Status: Autopilot Issue Delivery Worker (microsoft/apm, 4k stars), Tool Connector (ZhixiangLuo/10xProductivity, 478 stars), Golang Samber Hot (samber/cc-skills-golang, 3.4k stars) and Admin (grafana/skills, 281 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains ClawSweeper Status?

steipete (a GitHub user) maintains it in steipete/agent-scripts, which has 7,313 GitHub stars. The repository holds 45 skills in this directory. The repository was last updated on October 4, 2026.

Source: steipete/agent-scripts on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.