jira-sync

Synchronize SpecWeave increments and JIRA issues bidirectionally via REST API.

156|21|Updated Oct 25, 2025
One-click install
npx skills add https://github.com/anton-abyzov/specweave --skill jira-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jira-sync
Source: https://github.com/anton-abyzov/specweave/tree/main/.claude/skills/jira-sync
Command: npx skills add https://github.com/anton-abyzov/specweave --skill jira-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the manual effort and inconsistencies that arise from updating project management tools (JIRA) and development specifications (SpecWeave) separately. It ensures all stakeholders are always working with the most current information.

Core Features & Use Cases

  • Bidirectional Sync: Synchronizes JIRA Epics, Stories, and Sub-tasks with SpecWeave increments, including status, descriptions, and comments.
  • Automated Issue Creation: Automatically creates JIRA issues from your SpecWeave feature plans.
  • Status Alignment: Keeps the status of linked items in sync (e.g., "planned" in SpecWeave becomes "To Do" in JIRA).
  • Use Case: Automatically create JIRA stories and tasks from your SpecWeave feature plans. As your team updates task statuses in JIRA, the corresponding SpecWeave documents are updated, providing a single source of truth.

Quick Start

Sync increment 0001 to JIRA

Frequently Asked Questions about jira-sync

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

FAQPage Schema
How do I keep JIRA and SpecWeave synchronized automatically?

Bidirectional synchronization keeps JIRA issues and SpecWeave increments in sync through webhook-based automation. Changes to status, assignees, descriptions, and comments flow between systems, eliminating manual updates and ensuring a single source of truth across platforms.

Can I automatically create JIRA issues from SpecWeave feature plans?

Yes. The Skill exports SpecWeave increments to JIRA as Epics, Stories, and Sub-tasks with acceptance criteria, labels, and components included. This automation removes the need to manually recreate specifications in JIRA.

What happens when JIRA and SpecWeave have conflicting updates?

The Skill includes built-in conflict resolution and error management. When changes occur simultaneously in both systems, mapping rules and conflict handlers determine which update takes precedence, preventing data loss or inconsistency.

Does the sync work with JIRA REST APIs and custom workflow mappings?

Yes. Synchronization relies on JIRA REST API calls and jira-mapper coordination to enforce content-to-JIRA and status-to-SpecWeave mapping rules, supporting both standard and custom workflow configurations.

What content can I synchronize between the two platforms?

You can sync Epics, Stories, Sub-tasks, acceptance criteria, labels, components, status, assignees, and comments. The Skill handles both export from SpecWeave to JIRA and import of updates back to SpecWeave.