What happens if I manually try to check a box in tasks.md?

The skill intercepts the manual edit, blocks it to prevent data inconsistency, and automatically generates and runs the equivalent task-tracker command to update all relevant files simultaneously.

Is this skill compatible with both Windows and Unix-based systems?

Yes, it features platform detection logic to execute the appropriate task-tracker scripts for your environment, supporting both Bash and PowerShell workflows.

Which files does this skill primarily manage?

It manages the relationship between tasks.md (your checklist) and NOTES.md (your progress log), ensuring that updates to one are reflected accurately in the other.

Can it handle multiple tasks being worked on at once?

Yes, but it includes safety checks to prevent 'WIP bloat' by warning you if more than two tasks are marked as in-progress simultaneously.

How does this skill support Test-Driven Development (TDD)?

The skill includes validation logic that checks the status of related tasks; for example, it will warn you if you attempt to complete an implementation task before its corresponding test task is finished.

Task Status Synchronizer

Name: Task Status Synchronizer
Author: marcusgoll

bymarcusgoll

•

生产力与工作流

Ensures atomic synchronization between project task lists and progress notes by enforcing command-line tracking and preventing manual file edit inconsistencies.

The Task Status Synchronizer is a specialized skill for Claude Code that maintains absolute consistency between tasks.md and NOTES.md files. By intercepting manual edit attempts and converting them into atomic task-tracker commands, it eliminates data fragmentation and ensures that every checkbox update is accompanied by the necessary progress markers. It is particularly effective for teams using Spec-Driven Development, as it enforces TDD cycles, validates task transitions, and generates auditable artifacts with velocity metrics without requiring the user to remember complex CLI syntax.

主要功能

01Ensures 1:1 synchronization between tasks.md checkboxes and NOTES.md completion markers

02Monitors parallel work limits and detects file path conflicts between active tasks

0318 GitHub stars

04Enforces TDD workflows by validating that tests are completed before implementation tasks

05Automatically catches and fixes common mistakes like invalid task IDs or incorrect status transitions

06Intercepts manual file edits and auto-converts them into atomic task-tracker CLI commands

使用场景

01Maintaining a consistent project state and auditable history during Spec-Driven Development

02Automating the synchronization of implementation notes with technical task lists

03Preventing documentation drift and merge conflicts in shared task-tracking files

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add marcusgoll/spec-flow task-status-sync

For use in Claude.ai and ChatGPT

Download Skill