{"skill":{"slug":"task-status","displayName":"Task Status","summary":"Send short status descriptions in chat for long-running tasks. Use when you need to provide periodic updates during multi-step operations, confirm task completion, or notify of failures. Includes automated periodic monitoring that sends updates every 5 seconds, status message templates, and a helper function for consistent status reporting.","description":"---\nname: task-status\ndescription: Send short status descriptions in chat for long-running tasks. Use when you need to provide periodic updates during multi-step operations, confirm task completion, or notify of failures. Includes automated periodic monitoring that sends updates every 5 seconds, status message templates, and a helper function for consistent status reporting.\n---\n\n# Task Status Skill\n\n## Quick Start\n\n### Manual Status Updates\n```bash\npython scripts/send_status.py \"Starting data fetch...\" \"progress\" \"step1\"\npython scripts/send_status.py \"Processing complete\" \"success\" \"final\"\npython scripts/send_status.py \"Error: Missing API key\" \"error\" \"auth\"\n```\n\n### Automatic Periodic Monitoring (Every 5 seconds)\n```bash\n# Start monitoring a long-running task\npython scripts/monitor_task.py start \"My Long Task\" \"processing\"\n\n# Monitor will send \"Still working...\" updates every 5 seconds\n# When task completes, report final status\npython scripts/monitor_task.py stop \"My Long Task\" \"success\" \"Completed successfully!\"\n```\n\n## Status Types\n\n- **progress**: Ongoing work (shows 🔄 or ->)\n- **success**: Task complete (shows ✅ or OK)\n- **error**: Failed task (shows ❌ or !)\n- **warning**: Issue but continuing (shows ⚠️ or ?)\n\n## Periodic Monitoring\n\nThe `monitor_task.py` script provides automatic updates:\n\n### Starting Monitor\n```bash\npython scripts/monitor_task.py start \"<task_name>\" \"<status_type>\" [--interval <seconds>]\n```\n\n- Automatically sends \"Still working...\" updates every 5 seconds\n- Runs in background until stopped\n- Can be customized with different intervals\n\n### Stopping Monitor\n```bash\npython scripts/monitor_task.py stop \"<task_name>\" \"<final_status>\" \"<final_message>\"\n```\n\n### Example: Long File Processing\n```bash\n# Start monitoring\npython scripts/monitor_task.py start \"video_processing\" \"progress\"\n\n# ... long processing happens here ...\n\n# Stop with final status\npython scripts/monitor_task.py stop \"video_processing\" \"success\" \"Processing complete!\"\n```\n\n## Manual Updates (Quick Status)\n\nFor single status updates without monitoring:\n\n```bash\npython scripts/send_status.py \"Still fetching data...\" \"progress\" \"fetch\"\npython scripts/send_status.py \"Processing records: 250/1000\" \"progress\" \"process\"\npython scripts/send_status.py \"Complete! 3 files ready\" \"success\" \"final\"\npython scripts/send_status.py \"Error: Connection timeout\" \"error\" \"api\"\n```\n\n## When to Use Each Method\n\n### Use Manual Updates When:\n- Task is short (under 30 seconds)\n- You want control over when updates are sent\n- Task has discrete, meaningful milestones\n\n### Use Periodic Monitoring When:\n- Task is long-running (over 1 minute)\n- You want consistent \"heartbeat\" updates every 5 seconds\n- Task has long periods of quiet work\n- You want to reassure user that work is ongoing\n\n## Message Guidelines\n\nKeep status messages under 140 characters. Examples:\n\n- **Progress**: \"Still fetching data...\" or \"Processing records: 250/1000\"\n- **Success**: \"Complete! 3 files ready\" or \"Task finished successfully\"\n- **Error**: \"Error: Connection timeout\" or \"Failed: Missing API key\"\n- **Warning**: \"Continuing despite timeout\" or \"Partial success: 5/10 files\"\n\n## Advanced Usage\n\n### With Additional Details\n```bash\npython scripts/send_status.py \"Uploading...\" \"progress\" \"upload\" --details \"File: report.pdf (2.4MB)\"\n```\n\n### Different Intervals\n```bash\npython scripts/monitor_task.py start \"data_sync\" \"progress\" --interval 10\n```\n\n### Importing for Python Scripts\n```python\nfrom send_status import send_status\n\ndef long_task():\n    send_status(\"Starting...\", \"progress\", \"step1\")\n    # ... work\n    send_status(\"Step complete\", \"success\", \"step1\")\n```\n\n## Automation with Clawdbot Cron\n\nFor scheduled tasks, use Clawdbot's cron feature:\n\n```python\n# In a script or session\nfrom cron import add\n\n# Every 5 seconds, check status\njob = {\n    \"text\": \"Check status update\",\n    \"interval\": \"5s\",\n    \"enabled\": True\n}\nadd(job)\n```\n\nThis allows status updates even when you're not actively watching.\n\n## Installation\n\nTo use this skill, copy the `task-status` folder into your Clawdbot skills directory:\n\n```\nC:\\Users\\Luffy\\AppData\\Roaming\\npm\\node_modules\\clawdbot\\skills\\task-status\n```\n\nOr add it to your workspace and reference it from `AGENTS.md` or `TOOLS.md`.\n\nOnce installed, the skill will be available for any task where you need periodic status updates.","tags":{"latest":"1.0.0"},"stats":{"comments":1,"downloads":11270,"installsAllTime":109,"installsCurrent":109,"stars":12,"versions":1},"createdAt":1769504488946,"updatedAt":1779076502228},"latestVersion":{"version":"1.0.0","createdAt":1769504488946,"changelog":"- Initial release of the task-status skill for sending status updates on long-running tasks.\n- Supports manual status updates with a simple command-line script.\n- Includes automatic periodic monitoring, sending updates every 5 seconds during multi-step operations.\n- Provides message templates and a helper function for consistent status reporting.\n- Allows easy customization of update intervals and advanced usage within Python scripts or Clawdbot cron jobs.","license":null},"metadata":null,"owner":{"handle":"mightyprime1","userId":"s177cwv7hannwvh6aqfk1j2725885rz9","displayName":"Mightyprime1","image":"https://avatars.githubusercontent.com/u/13576702?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1779916984817}}