One-click install
npx skills add https://github.com/microsoft/upgrade-agent-plugins --skill tasks-consistency
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tasks-consistency
Source: https://github.com/microsoft/upgrade-agent-plugins/tree/main/plugins/upgrade-agent/upgrade/skills/system/tasks-consistency
Command: npx skills add https://github.com/microsoft/upgrade-agent-plugins --skill tasks-consistency

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps maintain synchronization between the authoritative task list in plan.md and the derived progress view in tasks.md, ensuring that both documents reflect the latest changes.

Core Features & Use Cases

  • Reconciliation Workflow: Automates the process of comparing and updating tasks.md to match plan.md when changes are detected.
  • Edge Case Handling: Manages scenarios like task removals, ID changes, and subtask-level details.
  • Verification Checklist: Provides a comprehensive checklist to ensure all tasks are correctly synchronized.

Quick Start

Run the tasks-consistency skill to reconcile tasks.md with plan.md.

Frequently Asked Questions about tasks-consistency

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

FAQPage Schema
How do I keep task lists synchronized between plan.md and tasks.md?

Task synchronization between plan.md and tasks.md is automated by comparing the authoritative plan against the derived progress view and directly editing tasks.md to reflect the latest changes. This ensures both markdown documents remain consistent upon every invocation.

What happens to tasks.md when tasks are removed or IDs change in plan.md?

Edge cases like task removals and ID changes in plan.md are handled automatically during file reconciliation. The process recalculates task states and updates tasks.md to ensure subtask-level details and overall task tracking remain accurately synchronized.

What is the best way to automate markdown file consistency checks for project management?

Automating markdown file consistency checks is best handled by running a reconciliation workflow that directly compares task tracking documents. It provides a verification checklist to ensure all project management tasks are correctly synchronized without manual review.

Do I need any external dependencies to run task reconciliation on markdown files?

No external dependencies are required to run task reconciliation on markdown files. The process relies solely on direct file editing and state recalculations within your project directory to synchronize plan.md and tasks.md.

How do I verify that subtask-level details are correctly synchronized across markdown files?

You can verify subtask-level synchronization by using the comprehensive verification checklist provided after the reconciliation workflow runs. This checklist confirms that all task information, including subtask details, matches between plan.md and tasks.md.