← Back to Skills Marketplace
Progress Reporter
by
zenmejiang-commits
· GitHub ↗
· v1.0.0
566
Downloads
0
Stars
3
Active Installs
1
Versions
Install in OpenClaw
/install progress-reporter
Description
Automatically reports task progress every 10 minutes during execution, including current status, recent work, overall progress, and next steps.
Usage Guidance
This skill appears to do what it says: periodically scan the local OpenClaw workspace for a running task and write human-readable progress reports into workspace directories. Before installing, check these points: 1) Cron/privileges: SKILL.md asks you to add a crontab entry for /root/.openclaw/..., which requires the user account that adds the cron job to have access to that path — if you install the cron as root it will run with root privileges. Only add the cron if you intend that persistence and privilege level. 2) Workspace paths: the script reads running task JSONs and .log files and writes markdown files under tasks/ and memory/. Ensure those directories contain only data you expect to be read and written locally. 3) No network exfiltration: the script does not make network calls or require credentials, but it will create report files that might be read by other processes — ensure those reports won't be forwarded to external services unless you want that. 4) Dependencies & portability: the script uses common POSIX utilities; jq is used to extract the task field but the script tolerates its absence. If your environment differs (non-root home, different workspace path), edit SKILL.md/report.sh to point to the correct workspace and verify cron user. 5) Logs and retention: the script produces files every run (every 10 minutes if you enable cron); consider log/retention policies to avoid storage growth. If you want tighter guarantees (no persistent cron, different paths, or reduced privilege), modify the crontab instruction and the script before enabling.
Capability Analysis
Type: OpenClaw Skill
Name: progress-reporter
Version: 1.0.0
The skill is a utility designed to generate periodic progress reports by monitoring local task and log files within the OpenClaw workspace. The core logic in `report.sh` uses standard shell utilities (bash, jq, grep, tail) to extract task metadata and recent logs, formatting them into markdown files stored locally. While it suggests adding a crontab entry for persistence, this behavior is transparently documented and directly supports the stated purpose of the skill without any evidence of data exfiltration or malicious command execution.
Capability Assessment
Purpose & Capability
Name/description match implementation: a cron-invoked shell script scans workspace running task JSON/logs and writes progress reports into tasks/ and memory/ directories. The requested files and behavior are proportional to a local progress-reporter.
Instruction Scope
SKILL.md instructs adding a crontab entry to run the included report.sh every 10 minutes and documents the output paths. The script reads /root/.openclaw/workspace/tasks/running/*.json and associated .log files and writes reports under the workspace. This is expected for the stated purpose, but installing the cron entry and the provided absolute /root path are environment-sensitive and require appropriate privileges.
Install Mechanism
No install spec or network downloads — instruction-only with an included script. Nothing is pulled from external URLs and no archives are extracted.
Credentials
The skill requires no environment variables or credentials. It reads local workspace files (task JSONs and logs) which are necessary for generating progress reports. No unrelated credentials or external service tokens are requested.
Persistence & Privilege
always is false and the skill does not modify other skills. However, SKILL.md instructs editing crontab to schedule the script, which grants persistent execution — the user must consciously install that cron entry (it is not automated). The suggested cron uses an absolute /root path, so installing it as root will run the reporter as root; that requires user attention.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install progress-reporter - After installation, invoke the skill by name or use
/progress-reporter - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of Progress Reporter - 定时进度汇报系统
- Automatically reports task progress every 10 minutes during task execution.
- Skips reporting when no task is running.
- Each report includes current state, work completed in the period, current progress, and next steps.
- Outputs detailed progress reports and notifications to structured files.
- Easy scheduling via a crontab example provided.
- Enables real-time oversight, timely intervention, and full process transparency.
Metadata
Frequently Asked Questions
What is Progress Reporter?
Automatically reports task progress every 10 minutes during execution, including current status, recent work, overall progress, and next steps. It is an AI Agent Skill for Claude Code / OpenClaw, with 566 downloads so far.
How do I install Progress Reporter?
Run "/install progress-reporter" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Progress Reporter free?
Yes, Progress Reporter is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Progress Reporter support?
Progress Reporter is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Progress Reporter?
It is built and maintained by zenmejiang-commits (@zenmejiang-commits); the current version is v1.0.0.
More Skills