How does this skill prevent file conflicts in todos.json?

The skill uses a dedicated API (POST /api/todos/complete) to handle status changes rather than editing files directly, which prevents data corruption if multiple processes are running.

What information is included in the Telegram update?

The notification includes the task title, ID, a markdown-formatted description of the work performed, a list of affected files, and a completion timestamp.

Where are the completed tasks stored after archiving?

Tasks are moved from the active list into an archives/ directory, saved as JSON files named with the date and time of completion.

Can I use this skill without sending Telegram notifications?

Yes, you can use the --no-notify flag to complete the task and archive it without triggering a Telegram message.

Heartbeat Task Automator

Name: Heartbeat Task Automator
Author: ttmouse

byttmouse

•

生産性とワークフロー

Automates the task completion lifecycle by updating status via API, sending Telegram notifications, and archiving finished work.

The Heartbeat Task Completion Skill provides a standardized, reliable method for closing out development tasks within an AI-driven workspace. By utilizing an API-driven approach rather than direct file manipulation, it ensures data integrity and prevents concurrency conflicts in shared todo files. The skill streamlines the post-development phase by automatically formatting and sending progress updates to Telegram, marking tasks as finished with precise timestamps, and organizing completed items into a dedicated archive for better workspace maintenance.

主な機能

01Automated Telegram notifications with rich markdown formatting

0235 GitHub stars

03API-driven task status updates to prevent todos.json file conflicts

04Built-in verification to ensure tasks exist and are currently active

05Instant archiving of completed tasks to a dedicated directory

06Detailed reporting of affected files and completion summaries

ユースケース

01Maintaining a clean project workspace by archiving finished items automatically

02Keeping remote teams updated on progress via instant Telegram alerts

03Closing out coding tasks automatically after an AI agent finishes a feature

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ttmouse/skills heartbeat-skill

For use in Claude.ai and ChatGPT

Download Skill