← Back to Skills Marketplace
Task Runner
by
johstracke
· GitHub ↗
· v1.0.1
1476
Downloads
1
Stars
6
Active Installs
2
Versions
Install in OpenClaw
/install task-runner
Description
Manage and track tasks and projects persistently with priorities, completion status, filtering, and secure markdown export across sessions.
Usage Guidance
This skill appears to do exactly what it claims: a local task tracker with a JSON DB and Markdown export. Before installing/using it, consider: (1) the export function allows writing anywhere in your home directory except for a short blacklist of filename patterns — if you want stronger safety, restrict exports to the workspace directory only; (2) review the blacklist (it omits some dotfiles and config locations like general .config or .bash_history) if you are concerned about accidental overwrites; (3) back up any important files you might overwrite and inspect ~/.openclaw/workspace/tasks_db.json if you care about what data the skill stores; (4) because the skill can be invoked autonomously by an agent (normal default), ensure you trust the agent prompts that would call export with user-supplied paths. If you want maximum safety, only export to files inside ~/.openclaw/workspace or /tmp.
Capability Analysis
Type: OpenClaw Skill
Name: task-runner
Version: 1.0.1
The skill bundle provides a task management utility with persistent storage and markdown export functionality. The `SKILL.md` clearly outlines its purpose and security measures, specifically regarding file export path validation. The `scripts/task_runner.py` implements a robust `is_safe_path` function that correctly restricts file exports to the OpenClaw workspace, user's home directory, or `/tmp`, while explicitly blocking system paths and sensitive dotfiles (e.g., `~/.ssh`, `~/.bashrc`). There is no evidence of data exfiltration, malicious execution, persistence mechanisms, prompt injection attempts against the agent, or obfuscation. The code's behavior is clearly aligned with its stated purpose and includes meaningful security controls.
Capability Assessment
Purpose & Capability
The SKILL.md and the included Python script both implement a local task manager: adding/listing/completing tasks and exporting projects to Markdown. There are no unrelated dependencies, environment variables, or external endpoints requested.
Instruction Scope
Runtime instructions only invoke the local script and describe local file exports/storage. The code does not access environment variables, network, or arbitrary system state. However, exports are allowed to the entire home directory (with a small list of blocked filename patterns), which is broader than the 'workspace-only' expectation some users might have.
Install Mechanism
No install spec is provided (instruction-only skill plus a script). Nothing is downloaded or written during install, so there is minimal install-time risk.
Credentials
The skill requires no environment variables or credentials. The only filesystem access is to a single JSON DB under ~/.openclaw/workspace and to user-provided export paths.
Persistence & Privilege
The skill does not request permanent/always-on inclusion and does not modify other skills or global agent configuration. It persists only its own tasks DB at ~/.openclaw/workspace/tasks_db.json.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install task-runner - After installation, invoke the skill by name or use
/task-runner - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Security fix: Added path validation to prevent malicious file writes. Export function now restricts output to safe directories (workspace, home, /tmp) and blocks system paths and sensitive dotfiles. Addresses vulnerability reported by VirusTotal scan.
v1.0.0
Initial release - Persistent task management across sessions. Features: add tasks with projects and priorities, list pending/completed tasks, mark tasks complete, export projects to markdown. Perfect for multi-session projects and maintaining productivity.
Metadata
Frequently Asked Questions
What is Task Runner?
Manage and track tasks and projects persistently with priorities, completion status, filtering, and secure markdown export across sessions. It is an AI Agent Skill for Claude Code / OpenClaw, with 1476 downloads so far.
How do I install Task Runner?
Run "/install task-runner" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Task Runner free?
Yes, Task Runner is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Task Runner support?
Task Runner is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Task Runner?
It is built and maintained by johstracke (@johstracke); the current version is v1.0.1.
More Skills