gh-sync

Starts a background sync of GitHub issues and PRs into the knowledge base.

24|9|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/norrietaylor/distillery --skill gh-sync
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gh-sync
Source: https://github.com/norrietaylor/distillery/tree/main/skills/gh-sync
Command: npx skills add https://github.com/norrietaylor/distillery --skill gh-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

GitHub issues and pull requests often live in isolation, making it hard to search, relate, and preserve decisions across projects. gh-sync bridges GitHub activity to Distillery's knowledge base, creating searchable, linkable entries that preserve provenance.

Core Features & Use Cases

  • Start a background sync for a repository and receive a job_id to monitor progress.
  • Retrieve progress for a single job or list recent jobs with status details.
  • Ensure issues and PRs are deduplicated and properly wired to cross-reference entries in the knowledge base.
  • Use cases include capturing decisions from issues/PRs for traceability and surfacing context alongside session notes.

Quick Start

Start a background GitHub sync for a repository by saying gh-sync owner/repo, then check progress with /gh-sync status <job_id>.

Frequently Asked Questions about gh-sync

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

FAQPage Schema
How do I sync GitHub issues and pull requests into a searchable knowledge base?▼

You can sync GitHub issues and pull requests into a searchable knowledge base by initiating a background process for a repository. This fetches, deduplicates, and links entries to preserve provenance and cross-reference context.

How do I monitor the progress of a GitHub repository sync?▼

To monitor a GitHub repository sync, use the job_id returned when the background sync starts. You can check the progress of a single job or list recent jobs to retrieve current status details.

How does deduplication work when synchronizing GitHub issues?▼

Deduplication during GitHub issue synchronization ensures that identical issues and pull requests are not imported multiple times. The backend handles fetching and processing to properly wire cross-reference entries.

Why sync GitHub issues into a knowledge base instead of leaving them in the repository?▼

Syncing GitHub issues into a knowledge base prevents decisions from living in isolation. It creates searchable, linkable entries that capture project context and surface traceability alongside session notes.

Do I need any external dependencies to start syncing GitHub pull requests?▼

No external dependencies are required to start syncing GitHub pull requests. The skill initiates the background sync directly and the backend MCP server handles the fetching and linking automatically.