po-sync-story

Synchronize story data from a local YAML file to Jira, ClickUp, or GitHub issues.

3|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/GDSDN/kord-aios --skill po-sync-story
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: po-sync-story
Source: https://github.com/GDSDN/kord-aios/tree/main/src/features/builtin-skills/kord-aios/product/po-sync-story
Command: npx skills add https://github.com/GDSDN/kord-aios --skill po-sync-story

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the synchronization of story details between your local development environment and your project management tool, ensuring consistency and reducing manual updates.

Core Features & Use Cases

  • Automated Sync: Pushes story updates from a local YAML file to integrated PM tools like Jira, ClickUp, or GitHub Issues.
  • Status Updates: Reflects the current status of a story in the PM tool.
  • URL Linking: Provides a direct link to the story in the PM tool upon successful sync.
  • Use Case: After updating a story's details in your story.yaml file, run this Skill to instantly reflect those changes in Jira, keeping your team's project tracking up-to-date.

Quick Start

Use the po-sync-story skill to sync the story located at 'path/to/story.yaml' to your configured project management tool.

Frequently Asked Questions about po-sync-story

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

FAQPage Schema
How do I sync local story data to Jira or ClickUp?

Story synchronization updates story details and status from a local YAML file to Jira, ClickUp, or GitHub Issues, ensuring consistency between your local environment and the external project management tool without manual updates.

Can I sync GitHub issues using a YAML file?

Yes, you can sync GitHub issues using a YAML file. The Skill supports integration with GitHub Issues via a pluggable adapter system, allowing you to push local story creation, updates, and status synchronization directly to your repository.

Does this tool support bi-directional sync between local files and project management tools?

This Skill performs outbound synchronization from a local YAML file to an external project management tool like Jira, ClickUp, or GitHub Issues. It handles story creation, updates, and status synchronization, but does not support pulling changes back from the PM tool.

What is the best way to keep Jira issues updated from a local development environment?

The best way to keep Jira issues updated from a local environment is to maintain your story details in a local YAML file and run this Skill to automatically push updates, status changes, and new stories to Jira, keeping your team's project tracking up-to-date.

Why do I need a YAML file to sync stories to my project management tool?

You need a YAML file to sync stories because it serves as the local source of truth for story data. The Skill reads story details from the YAML file and synchronizes them to Jira, ClickUp, or GitHub Issues, ensuring consistency and reducing manual updates.

Do I need to install additional dependencies to sync stories to ClickUp?

No, you do not need to install additional dependencies to sync stories to ClickUp. The Skill uses a built-in pluggable adapter system to integrate with ClickUp, Jira, and GitHub Issues without requiring external dependencies.