Which sync direction is best for teams?

Bidirectional sync is usually recommended for teams, as it allows updates to flow from developers to the project board and reflects status changes made by managers in the external tool.

What is the 'local source of truth' principle?

SpecWeave treats your local directory as the primary authority. External tools like Jira or GitHub are mirrors of your local documentation and task files.

How does the wizard handle sync conflicts?

When both local and external sources change, the wizard provides a diff view and prompts you to choose whether to keep local changes, keep external changes, or perform a manual merge.

What authentication is required for GitHub sync?

It is recommended to have the GitHub CLI (gh) installed and authenticated. The wizard will guide you through connecting to your specific repository.

Can I sync GitHub and Jira simultaneously?

Yes. SpecWeave acts as the central hub, syncing independently with both platforms. Changes to your local files will propagate to both GitHub and Jira based on your settings.

External Sync Wizard

Name: External Sync Wizard
Author: anton-abyzov

byanton-abyzov

•

Collaboration Tools

Synchronizes local SpecWeave specifications and tasks with project management tools like GitHub, Jira, and Azure DevOps.

The External Sync Wizard is a specialized skill designed to bridge the gap between local development and team-wide project management platforms. It implements a hub-and-spoke architecture where SpecWeave remains the local source of truth, while external platforms like GitHub Issues, Jira Epics, and Azure DevOps Work Items serve as mirrors. By providing interactive setup wizards and flexible synchronization directions—including bidirectional, export-only, and import-only—it ensures that project documentation, task progress, and planning increments stay perfectly aligned across all systems with minimal manual effort.

Key Features

01Flexible sync modes: Bidirectional, Export-only, Import-only, or Manual

02Automated task completion hooks for real-time project updates

0313 GitHub stars

04Multi-platform support for GitHub Issues, Jira Epics, and Azure DevOps

05Conflict resolution guidance for maintaining data integrity across tools

06Interactive setup wizards for authentication and configuration

Use Cases

01Mirroring local development progress to a team's GitHub Issues board

02Onboarding existing external projects into a local-first SpecWeave workflow

03Syncing SpecWeave increments with Jira Epics for corporate tracking and reporting

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add anton-abyzov/specweave external-sync-wizard

For use in Claude.ai and ChatGPT

Download Skill