SkillHub

tasks-md-sprint-sync

v1.0.0

Sync TASKS.md current phase and in-progress checklist from the active PLAN.md phase to keep sprint execution aligned.

Sourced from ClawHub, Authored by Daniel Lummis

Installation

Please help me install the skill `tasks-md-sprint-sync` from SkillHub official store. npx skills add daniellummis/tasks-md-sprint-sync

Tasks.md Sprint Sync

Use this skill to keep a project's TASKS.md section aligned with whatever phase is marked IN PROGRESS in that project's PLAN.md.

What this skill does

  • Reads the active phase from PLAN.md (phase with **Status: IN PROGRESS**)
  • Extracts bullets from that phase's ### Work section
  • Finds the target project section in TASKS.md
  • Reports drift between plan work items and ### In progress tasks
  • Optionally updates TASKS.md to match plan phase + work items

Inputs

Required: - PROJECT_NAME (the exact heading in TASKS.md, e.g. ClawHub Skills)

Optional: - PLAN_FILE (default: PLAN.md) - TASKS_FILE (default: TASKS.md) - SYNC_MODE (report or apply, default: report)

Run

Dry-run drift report:

PROJECT_NAME="ClawHub Skills" 
PLAN_FILE=projects/clawhub-skills/PLAN.md 
TASKS_FILE=TASKS.md 
bash skills/tasks-md-sprint-sync/scripts/sync-tasks-phase.sh

Apply sync to TASKS.md:

PROJECT_NAME="ClawHub Skills" 
PLAN_FILE=projects/clawhub-skills/PLAN.md 
TASKS_FILE=TASKS.md 
SYNC_MODE=apply 
bash skills/tasks-md-sprint-sync/scripts/sync-tasks-phase.sh

Run against included fixtures:

PROJECT_NAME="Demo Project" 
PLAN_FILE=skills/tasks-md-sprint-sync/fixtures/PLAN.sample.md 
TASKS_FILE=skills/tasks-md-sprint-sync/fixtures/TASKS.sample.md 
SYNC_MODE=apply 
bash skills/tasks-md-sprint-sync/scripts/sync-tasks-phase.sh

Output contract

  • Exit 0 when report/apply completes
  • Exit 1 on invalid inputs, missing sections, or no active phase
  • In report mode: prints missing/extra task drift, no file changes
  • In apply mode: updates Current phase + replaces In progress list for the target project section