collaboration-helper

# Collaboration Helper ## Overview `scripts/collaboration_helper.py` is a lightweight JSON-backed tracker for community action items: - `list` shows every open or in-progress task with owner, priority, and creation timestamp. - `add` creates a new entry using `--owner`, `--priority`, and optional `--note` fields to capture context. - `complete` marks a task as finished and records who closed it. The data lives in `data/tasks.json`, so the collaboration state survives across skill runs and reboots. ## CLI usage - `python3 skills/collaboration-helper/scripts/collaboration_helper.py list` prints the current queue grouped by status (open/in progress/done). - `add "Review policy" --owner legal --priority high --note "Need quotes for Moltbook post"` registers a new task with metadata. - `complete 1 --owner ops` marks task `id=1` as done and stores the time/owner. - `--workspace /path/to/workspace` lets you point at another repo's `data/tasks.json` when you want to sync or inspect a partner workspace. ## Task data structure Each entry in `skills/collaboration-helper/data/tasks.json` looks like: ```json { "id": <number>, "title": "Task title", "owner": "owner-name", "priority": "low|medium|high", "status": "open|in-progress|done", "created_at": "2026-02-03T12:00:00Z", "note": "optional context" } ``` The CLI automatically increments `id`, sets timestamps, and toggles `status` when you complete an item. ## Example workflow ```bash python3 skills/collaboration-helper/scripts/collaboration_helper.py add "Document governance" --owner legal --priority high python3 skills/collaboration-helper/scripts/collaboration_helper.py list python3 skills/collaboration-helper/scripts/collaboration_helper.py complete 3 --owner legal ``` This adds a governance action, lists the queue so the team knows what’s pending, and then closes task `3` once it’s done. ## References - `data/tasks.json` stores the canonical task list. - `references/collaboration-guidelines.md` (if present) explains how the community prioritizes items and runs handoffs. ## Resources - **GitHub:** https://github.com/CrimsonDevil333333/collaboration-helper - **ClawHub:** https://www.clawhub.ai/skills/collaboration-helper