sync-push

Push local taskboard ticket changes to the GitHub Project board.

5|1|Updated Feb 11, 2026
One-click install
npx skills add https://github.com/Tristan578/project-forge --skill sync-push-tristan578
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-push
Source: https://github.com/Tristan578/project-forge/tree/main/.agents/skills/sync-push
Command: npx skills add https://github.com/Tristan578/project-forge --skill sync-push-tristan578

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Push local taskboard changes to the GitHub Project board by creating draft issues for new tickets and updating statuses for changed tickets.

Core Features & Use Cases

  • Incremental push: syncs todo, in_progress, and updated tickets without touching done items.
  • Full push: backfill all tickets including done items to ensure complete alignment.
  • Status checks: verify synchronization state between local taskboard and GitHub Projects.
  • Automatic synchronization runs after responses and can be triggered manually for bulk operations.

Quick Start

Run the incremental push to synchronize the local taskboard with the GitHub Project board.

Frequently Asked Questions about sync-push

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

FAQPage Schema
How do I sync a local taskboard with GitHub Projects?

Syncing a local taskboard with GitHub Projects involves pushing local ticket changes to the board to create draft issues for new tickets and update statuses for changed ones.

What is the difference between incremental push and full push for taskboard syncing?

Incremental push syncs todo and in_progress tickets plus changed statuses without touching done items. Full push backfills all tickets including done items to ensure complete alignment between local and GitHub Project boards.

Do I need the gh CLI to push local tickets to GitHub Projects?

Yes, you need gh CLI authentication to push local tickets to GitHub Projects. Additional prerequisites include the Taskboard API running on port 3010 and Python 3 availability in your environment.

How can I verify if my local taskboard is synchronized with GitHub Projects?

You can verify synchronization state between your local taskboard and GitHub Projects by running status checks. This compares the local tickets against the GitHub Project board to identify any misalignment.

Can I automate taskboard synchronization with GitHub Projects after responses?

Yes, automatic synchronization runs after responses. You can also trigger manual bulk operations to push local taskboard ticket changes to the GitHub Project board when needed.

When should I run a full push instead of incremental sync for GitHub Project boards?

Run a full push to backfill all tickets including done items when you need to ensure complete alignment between your local taskboard and GitHub Projects. Use incremental sync for routine updates to avoid touching completed items.