progress-sync

What This Skill Does

The progress-sync skill is the primary orchestration engine for SpecWeave, designed to act as a unified bridge between local project files and external project management platforms. At its core, this skill enables the /sw:sync-progress command, which serves as a single-button solution to synchronize state between tasks.md, technical specifications, living documentation, and external issue trackers like GitHub, JIRA, or Azure DevOps.

The most powerful feature of this skill is its mandatory auto-creation policy. When triggered, the skill inspects the increment status; if an external link is absent, it automatically triggers the appropriate creation tool (e.g., sw-github:create) to establish an audit trail. This eliminates manual setup friction, ensuring that every piece of work—whether active or archived—is represented in your team's centralized management platform. By automating the propagation of progress, it maintains consistency across systems without requiring constant manual intervention.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/anton-abyzov/sw-progress-sync Once installed, the /sw:sync-progress command becomes available globally within your project directories.

Use Cases

• Project Onboarding: When you initiate a new increment, use this to instantly provision all corresponding external issues across your toolchain.
• End-of-Sprint Housekeeping: Use it before closing an increment to ensure every task completion is reflected in your project management dashboard, even for historical audit purposes.
• Recovering from Sync Failures: If external hooks fail to trigger due to network instability, this skill forces a comprehensive reconciliation of all task states.
• Cross-Platform Consistency: Maintaining alignment between localized developer tasks and management-level boards.

Example Prompts

1. "I've finished the implementation for this increment. Please run /sw:sync-progress to update all linked JIRA tickets and close out the tasks."
2. "I just created this increment but realized no GitHub issue was linked. Can you run /sw:sync-progress to auto-create the missing issue and sync my status?"
3. "Sync everything up—I need the latest progress in tasks.md reflected in our Azure DevOps board immediately."

Tips & Limitations

• Tip: Always verify your tasks.md format before syncing, as the skill derives its state from these documents.
• Tip: If you have a specific requirement to avoid auto-creation, remember to use the --no-create flag.
• Limitation: The skill is designed for multi-system orchestration; avoid using it if you only intend to sync a specific, single sub-component, as that may trigger unnecessary API calls to all connected platforms. Use specialized commands like /sw:sync-acs for granular updates.