← Back to Skills Marketplace
Task Watcher Skill
by
_silhouette
· GitHub ↗
· v1.2.1
308
Downloads
0
Stars
3
Active Installs
5
Versions
Install in OpenClaw
/install task-watcher
Description
Monitor async tasks by polling their state and send Discord/Telegram notifications on changes or completion for workflows like CI/CD, deployments, or reviews.
Usage Guidance
This skill appears coherent and self-contained, but before installing: 1) Confirm who can create/modify tasks.jsonl in ~/.openclaw/shared-context — a task entry can point the adapter at arbitrary packet paths and cause the watcher to read those files. Limit write access to that directory to trusted agents/users. 2) Ensure OpenClaw agent (and its delivery credentials) is configured securely; this skill delegates delivery to the agent and does not itself hold provider secrets. 3) If you rely on Discord delivery, test with dry_run=true first to verify messages and file paths. 4) If you run the watcher via cron, inspect the cron job, log rotation, and file permissions so sensitive data in audit/notification files isn't exposed. 5) Note Telegram notifier is a placeholder; production Telegram delivery is not implemented in this package.
Capability Analysis
Type: OpenClaw Skill
Name: task-watcher
Version: 1.2.1
The task-watcher skill bundle is a well-structured asynchronous monitoring system designed to track task states (like content reviews or CI/CD jobs) and send notifications. The code follows a clean, modular architecture using the Python standard library, with clear separation between data persistence (JsonlTaskStore), state checking (Adapters), and notification delivery (Notifiers). While it utilizes subprocess.run in notifiers.py to trigger Discord alerts via the OpenClaw CLI, it does so using safe argument lists and for the explicitly stated purpose of the skill. No evidence of malicious intent, data exfiltration, or prompt injection was found.
Capability Assessment
Purpose & Capability
Name/description (watch async tasks and notify) matches the code and SKILL.md: adapters check state from local registries/packet files, policies decide when to notify, and notifiers deliver via OpenClaw or session/file. No unrelated binaries or unrelated cloud credentials are requested.
Instruction Scope
Runtime instructions and code operate on files under ~/.openclaw/shared-context (tasks.jsonl, audit.log, notifications). The watcher runs as a cron job and calls adapters that read registry/packet/mock files. This is expected for the stated purpose, but the adapter logic will read files referenced in tasks (packet_path, registry entries) — review who/what can create tasks to avoid unintended file reads.
Install Mechanism
No install spec in the registry (instruction-only install via clawhub or git clone). The repository contains pure-Python stdlib code; there are no downloads from arbitrary URLs or package installs in the manifest.
Credentials
The skill requests no environment variables or credentials. Notification delivery is delegated to the OpenClaw agent CLI (so any provider credentials are expected to be managed by OpenClaw, not by this skill). Code does reference local binary paths (node, openclaw) but does not require global secrets.
Persistence & Privilege
The skill stores state under ~/.openclaw/shared-context and writes audit/notification files there. It does not set always: true and does not modify other skills. It runs as a cron-invoked script (periodic execution) which is appropriate for the purpose.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install task-watcher - After installation, invoke the skill by name or use
/task-watcher - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.1
v1.2.1: Isolate all tests from host filesystem (no ~/.openclaw writes), add .gitignore and MIT LICENSE. Fully portable: clone + pytest works anywhere.
v1.2.0
v1.2.0: Fix test imports for standalone use, add README, add conftest.py. 130 tests pass out of the box after git clone.
v1.0.2
Fix: support both package and standalone import modes. Verified end-to-end with real Discord notifications from installed skill.
v1.0.1
Fix import paths for standalone use, default timeout 48h→6h, update SKILL.md documentation
v1.0.0
Initial release: async task monitoring with Discord notifications, XHS/GitHub/Cron adapters, 130 unit tests
Metadata
Frequently Asked Questions
What is Task Watcher Skill?
Monitor async tasks by polling their state and send Discord/Telegram notifications on changes or completion for workflows like CI/CD, deployments, or reviews. It is an AI Agent Skill for Claude Code / OpenClaw, with 308 downloads so far.
How do I install Task Watcher Skill?
Run "/install task-watcher" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Task Watcher Skill free?
Yes, Task Watcher Skill is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Task Watcher Skill support?
Task Watcher Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Task Watcher Skill?
It is built and maintained by _silhouette (@lanyasheng); the current version is v1.2.1.
More Skills