Projectpilot

Lightweight project management for agents. Create projects, track tasks, set priorities and deadlines.

Security Scan

The skill's code and instructions match its stated purpose (a local, zero-dependency project/task tracker); it stores JSON files locally and does not request credentials or perform network activity, with only minor inconsistencies to note.

Purpose & Capability

Name/description (lightweight project management) align with included files and a small Python CLI that creates and manages per-project JSON files. The code implements the advertised commands and features.

Instruction Scope

SKILL.md instructs the agent to run the included Python CLI (python3 scripts/project_tracker.py) and to read/write project JSON under the workspace. This is within the stated purpose, but the SKILL metadata did not declare 'python3' as a required binary; the agent will need python3 available to run the CLI. The code only reads/writes files under the configured DATA_DIR and does not access other system config or network resources.

Install Mechanism

No install spec (instruction-only with a bundled script). No downloads or external install steps are present; the script is local and uses only the standard library.

Credentials

The script respects an optional PROJECTPILOT_DATA env var to override the data directory; this env var is not listed in the skill's required envs but is optional and not a credential. No secrets, tokens, or unrelated environment variables are requested.

Persistence & Privilege

The skill is not always-on and does not request elevated persistence. It writes only its own JSON files to a workspace data directory (default: ~/.openclaw/workspace/data/projects) and does not modify other skill configurations or system-wide settings.

Assessment

This skill appears coherent and implements a local project tracker that writes JSON files in a workspace directory. Before installing: ensure python3 is available (the SKILL.md uses 'python3' though the registry didn't list it), verify you trust the source since the script will create and modify files under your home directory (default ~/.openclaw/workspace/data/projects), and optionally set PROJECTPILOT_DATA to a dedicated folder if you want the data placed elsewhere. The code contains path-sanitization and path-traversal guards and makes no network calls or credential requests, so the risk is limited to local file writes.

Lightweight project management for agents. Track tasks, deadlines, and priorities with a zero-dependency Python CLI.

Quick Start

# Create a project
python3 scripts/project_tracker.py init my-project

# Add tasks
python3 scripts/project_tracker.py add my-project "Design API schema" --priority H --due 2026-04-05
python3 scripts/project_tracker.py add my-project "Write docs" --priority M --assignee rc

# List tasks
python3 scripts/project_tracker.py list my-project
python3 scripts/project_tracker.py list my-project --status todo --priority H

# Update / complete
python3 scripts/project_tracker.py done my-project <task_id>
python3 scripts/project_tracker.py update my-project <task_id> --status doing

# Insights
python3 scripts/project_tracker.py summary my-project
python3 scripts/project_tracker.py burndown my-project
python3 scripts/project_tracker.py overdue my-project
python3 scripts/project_tracker.py projects

All paths are relative to this skill directory.

Commands Reference

Command	Purpose
init <project>	Create new project
add <project> <task>	Add task (opts: --priority H/M/L, --due YYYY-MM-DD, --assignee)
list <project>	List tasks (opts: --status todo/doing/done, --priority)
update <project> <id>	Update task fields (--status, --priority, --due)
done <project> <id>	Mark task complete
delete <project> <id>	Remove task
summary <project>	Stats dashboard with progress bar
burndown <project>	Visual completion progress
overdue <project>	Show past-due tasks
projects	List all projects

Generating Status Reports

After running summary, format a status report using the template in references/pm-templates.md. Include completed items, in-progress work, blockers, and metrics.

Priority Scoring

Use the RICE framework from references/pm-templates.md when the user needs to prioritize a backlog or compare features.

Data Storage

Projects are stored as JSON in data/projects/ under the OpenClaw workspace. Each project is a single file — easy to version, export, or share.