Tasks.md Sprint Sync for Openclaw

Automatically sync your active project phase and task checklist from PLAN.md to TASKS.md to ensure development alignment.

daniellummis
v1.0.0
Mar 6, 2026
0
880
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install tasks-md-sprint-sync

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install tasks-md-sprint-sync using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Tasks.md Sprint Sync?

Tasks.md Sprint Sync is a developer-focused utility designed to maintain a single source of truth between project planning and task execution. By programmatically linking your planning documentation with your active task list, it eliminates the manual overhead of updating multiple markdown files during a sprint. This skill is a core component of the Openclaw Skills ecosystem, helping developers maintain high-velocity workflows without documentation drift.

The skill specifically targets project structures where PLAN.md defines the roadmap and TASKS.md tracks daily progress. It parses the active phase of a plan and ensures that the 'In Progress' section of your task list perfectly mirrors the intended work items.

Tasks.md Sprint Sync Use Cases

  • Synchronizing the active phase from a roadmap to a global task tracker.
  • Auditing project documentation to identify discrepancies between planned work and active tasks.
  • Automating the transition between sprint phases in a multi-project repository.
  • Ensuring project stakeholders see the correct 'current phase' reflected in top-level task files.

How Tasks.md Sprint Sync Works

  1. The skill scans the specified PLAN.md file to locate the phase marked with the Status: IN PROGRESS metadata.
  2. It extracts all bullet points from the ### Work subsection of that active phase.
  3. It identifies the target project heading within the TASKS.md file using the PROJECT_NAME variable.
  4. It performs a drift analysis to compare planned work items against existing tasks in the ### In progress list.
  5. Depending on the configuration, it either generates a report of the drift or applies the updates directly to the TASKS.md file.

Tasks.md Sprint Sync Setup

This skill requires bash and python3. To use this within the Openclaw Skills framework, you can run the script with environment variables to define your project context.

# Run a drift report (dry-run)
PROJECT_NAME="Your Project Name" \
PLAN_FILE="path/to/PLAN.md" \
TASKS_FILE="TASKS.md" \
bash skills/tasks-md-sprint-sync/scripts/sync-tasks-phase.sh

# Apply the sync and update TASKS.md
PROJECT_NAME="Your Project Name" \
SYNC_MODE=apply \
bash skills/tasks-md-sprint-sync/scripts/sync-tasks-phase.sh

Tasks.md Sprint Sync Data Schema & Taxonomy

The skill interacts with specific markdown structures to ensure data integrity:

Source Element Location Description
Active Phase PLAN.md Phase containing **Status: IN PROGRESS**
Work Items PLAN.md Bullets extracted from the ### Work section
Target Section TASKS.md The H2 or H3 heading matching PROJECT_NAME
Sync Target TASKS.md The ### In progress list under the project heading

Tasks.md Sprint Sync Advanced Features

  • Dual-mode operation: Use report mode for CI/CD linting or apply mode for automated updates.
  • Support for custom file paths allowing synchronization across nested directory structures.
  • Intelligent drift detection that identifies both missing work items and extra tasks not in the plan.
  • Seamless integration into Openclaw Skills workflows for multi-agent project management.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins bashpython3
Github Stars: 0
forks: 0

Featured*