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.