backlog-sync

Create and merge GitHub PRs from local backlog directory changes.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/jmbeach/vat --skill backlog-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: backlog-sync
Source: https://github.com/jmbeach/vat/tree/main/.claude/skills/backlog-sync
Command: npx skills add https://github.com/jmbeach/vat --skill backlog-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, and includes scripts (resource) components.

What problem does it solve?

This Skill automates the process of syncing local changes to a GitHub repository's backlog by creating and merging a short-lived chore PR.

Core Features & Use Cases

  • Automated PR Creation: Syncs changes from the local backlog/ directory to GitHub via a PR.
  • Branch Management: Creates a temporary branch, commits changes, opens a PR, squashes and merges it, and switches back to main.
  • Use Case: Ideal for teams using GitHub and a backlog/ directory for task management, ensuring that local changes are automatically reflected in the repository.

Quick Start

Sync your backlog changes by invoking the 'backlog-sync' skill.

Frequently Asked Questions about backlog-sync

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

FAQPage Schema
How do I automate GitHub PR creation for syncing local backlog changes?

You can automate syncing local backlog changes by using a script that creates a temporary branch, commits the 'backlog/' directory updates, opens a PR, and automatically squashes and merges it back to 'main'.

Do I need the gh CLI tool to automate pull requests for backlog management?

Yes, automating pull requests for backlog management requires the 'gh' CLI tool installed, alongside a valid GitHub token, to handle branch creation, PR opening, and merge operations via the GitHub API.

What is the best way to sync a local backlog directory to a remote GitHub repository?

The best way to sync a local backlog directory is to automate a short-lived chore PR workflow that commits local changes, pushes a temporary branch, and squashes and merges the updates into the remote 'main' branch.

Can I use GitHub Actions to automatically merge synced backlog PRs?

You can automatically merge synced backlog PRs by executing a branch management process that opens a pull request and immediately squashes and merges it, switching your local environment back to the 'main' branch upon completion.

Does automated branch management for backlog syncing switch back to main after merging?

Yes, automated branch management for backlog syncing switches your local repository back to the 'main' branch immediately after the temporary chore PR is squashed and merged into the remote repository.