external-sync-wizard
Expert guide for setting up bidirectional sync between SpecWeave and GitHub Issues, JIRA, or Azure DevOps. Use when configuring external tool integration, mapping fields between systems, or troubleshooting sync issues. Covers webhook setup, authentication, and conflict resolution strategies.
Why use this skill?
Master your project workflow with the external-sync-wizard. Easily configure bidirectional sync between SpecWeave specs and external trackers like GitHub, Jira, and ADO.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/anton-abyzov/sw-external-sync-wizardWhat This Skill Does
The external-sync-wizard is an expert OpenClaw agent skill designed to bridge the gap between your local source of truth—SpecWeave—and external project management platforms including GitHub Issues, Jira, and Azure DevOps. This skill serves as a high-level architectural advisor, helping you configure, manage, and troubleshoot bidirectional sync workflows. By treating your local .specweave/docs/specs/ directory as the definitive source, the wizard ensures that your documentation and external task trackers remain perfectly aligned without creating conflicting "source of truth" scenarios.
Installation
To integrate this expert guide into your OpenClaw environment, execute the following command in your terminal:
clawhub install openclaw/skills/skills/anton-abyzov/sw-external-sync-wizard
Use Cases
This skill is essential for software engineering teams and project managers who want to automate their documentation-to-ticket workflow. Common use cases include:
- Initial setup: Configuring the initial handshake between local spec files and a GitHub repository.
- Migration: Importing existing Jira Epics or Azure DevOps Work Items into SpecWeave for consolidation.
- Workflow Standardization: Defining sync directions (Bidirectional, Export-only, or Import-only) to maintain consistent status updates.
- Troubleshooting: Resolving sync conflicts that occur when team members update a GitHub issue and a SpecWeave increment simultaneously.
Example Prompts
- "I need to set up bidirectional sync between my local increments and GitHub issues. Walk me through the authentication and configuration steps."
- "What is the best way to migrate my current Jira Epic workflow into SpecWeave without breaking existing issue links?"
- "I have a sync conflict where my Azure DevOps status isn't updating when I mark a task complete in SpecWeave. Can you help me debug the connection?"
Tips & Limitations
- Source of Truth Principle: Always keep the local spec files as the primary authority. Never attempt to sync GitHub directly with Jira using this tool; it is designed solely for local-to-external communication.
- Scope: The skill focuses on active increments. Abandoned or completed legacy items may require manual reconciliation.
- Security: Ensure your GitHub CLI (gh) is authenticated before initiating the wizard for a seamless setup experience.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-anton-abyzov-sw-external-sync-wizard": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-read, file-write, external-api
Related Skills
network-engineer
Cloud network architect for VPC design, service mesh, zero-trust networking, load balancers, and CDN optimization. Use for network troubleshooting or connectivity issues.
jira-multi-project-mapper
Expert in mapping SpecWeave specs to multiple JIRA projects with intelligent project detection and cross-project coordination. Use when syncing to multiple JIRA projects (project-per-team, component-based), or managing bidirectional sync across team boundaries.
helm-chart-scaffolding
Design, organize, and manage Helm charts for templating and packaging Kubernetes applications with reusable configurations. Use when creating Helm charts, packaging Kubernetes applications, or implementing templated deployments.
performance-optimization
React Native performance with Hermes V1, FlashList, expo-image v2, concurrent rendering. Use for slow app, memory leaks, or FPS issues.
release-strategy-advisor
Release strategy advisor - detects brownfield patterns (tags, CI/CD, changelogs), recommends versioning strategy based on architecture. Creates release-strategy.md.