task-status-sync

Convert manual task file edits into atomic task-tracker commands.

91|10|Updated Oct 4, 2025
One-click install
npx skills add https://github.com/marcusgoll/Spec-Flow --skill task-status-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: task-status-sync
Source: https://github.com/marcusgoll/Spec-Flow/tree/main/.codex/skills/task-status-sync
Command: npx skills add https://github.com/marcusgoll/Spec-Flow --skill task-status-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Enforces atomic task status updates by routing manual edits through a task-tracker, preventing desynchronization between tasks.md and NOTES.md.

Core Features & Use Cases

  • Enforce task-tracker usage for status changes
  • Auto-convert manual edits into task-tracker commands
  • Supports interception, conversion, and atomic updates

Quick Start

Detect manual edits and auto-convert to task-tracker commands; see conversion rules in references.

Frequently Asked Questions about task-status-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent task status desynchronization between tasks.md and NOTES.md?

Task status desynchronization occurs when manual edits bypass coordination logic. This Skill enforces atomic task status synchronization by routing all updates through task-tracker commands, ensuring tasks.md and NOTES.md stay in sync regardless of whether changes originate from direct file edits, verbal progress mentions, or progression events.

Can I auto-convert manual edits to task-tracker commands?

Yes. This Skill detects manual edits and writes to target files, extracts task IDs and intended status, validates transitions, and automatically converts edits into task-tracker commands like mark-done-with-notes, mark-in-progress, mark-failed, and sync-status for atomic execution.

What types of task status changes does this Skill handle?

The Skill handles task completion with notes, progression to in-progress status, failure reports, and general status synchronization. It intercepts direct file edits, note additions, and verbal status mentions, converting each into the appropriate task-tracker command.

How does atomic task status update work in practice?

Atomic updates mean all task state changes execute as a single indivisible operation. The Skill validates state transitions before execution, preventing partial or conflicting updates, then applies the command atomically and provides feedback on the result.

What happens if I manually edit tasks.md instead of using task-tracker commands?

The Skill detects the manual edit, extracts the task ID and new status, validates whether the transition is allowed, then converts it into the corresponding task-tracker command and executes it atomically to maintain synchronization.