skills.rest
Emasoft
EmasoftCOMMUNITY
Explore all skills by this author →
Website𝕏@fmuaddibGitHub

eia-github-projects-sync

Synchronize GitHub Projects V2 with CI/PR states via GraphQL and webhooks.

Updated Aug 23, 2026
Search Tags:#automation#github#graphql#projects#webhook#kanban#ci
One-click install
npx skills add https://github.com/Emasoft/emasoft-integrator-agent --skill eia-github-projects-sync
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: eia-github-projects-sync
Source: https://github.com/Emasoft/emasoft-integrator-agent/tree/main/skills/eia-github-projects-sync
Command: npx skills add https://github.com/Emasoft/emasoft-integrator-agent --skill eia-github-projects-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill provides the Integrator Agent with a reliable mechanism to synchronize GitHub Projects V2 with CI/PR states, ensuring project boards accurately reflect real progress and automated workflows.

Core Features & Use Cases

  • GitHub Projects V2 synchronization: read project state and apply status mutations via GraphQL to reflect current work.
  • CI/PR integration and AI Maestro notifications: process CI results and PR events to trigger status changes and orchestrator alerts.
  • Webhook-driven automation: receive GitHub events and route updates to the appropriate agents, updating dashboards and reports.
  • Cross-repo coordination: support multi-repo projects and project boards for teams.

Quick Start

To begin, configure the webhook secret and start the webhook server, then connect to the project board and run the Kanban sync:

  • Set environment variable GITHUB_WEBHOOK_SECRET and start the webhook server: python scripts/ci_webhook_handler.py --port 9000
  • Run Kanban sync to reconcile CI/PR state: python scripts/kanban_sync.py --owner <owner> --repo <repo> --project <number>

Frequently Asked Questions about eia-github-projects-sync

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

FAQPage Schema
How do I sync GitHub Projects V2 with CI and PR states?▼

To sync GitHub Projects V2 with CI and PR states, run the kanban_sync.py script with your repository owner, repo name, and project number to reconcile board statuses via GraphQL mutations.

Can I automate Kanban board status transitions using GitHub webhooks?▼

Yes, you can automate Kanban board status transitions by deploying the ci_webhook_handler.py server, setting a GITHUB_WEBHOOK_SECRET, and routing PR and CI events to enforce state changes like In Review or Done.

Does this GitHub Projects sync tool support cross-repo coordination?▼

Yes, the tool supports cross-repo coordination by allowing multi-repo project boards to be aligned via GraphQL queries, ensuring teams can track sprint progress across different repositories.

How do CI outcomes affect project board columns in GitHub Projects V2?▼

CI outcomes directly affect project board columns by triggering status mutations that enforce transitions between Backlog, Todo, In Progress, In Review, Blocked, and Done based on CI results and PR merges.

What's the best way to assign GitHub issues to agents and track sprint progress?▼

The best way to assign issues to agents and track sprint progress is by using GraphQL operations to read project data, apply status mutations, and send webhook-driven automation alerts to the orchestrator.

Do I need a webhook secret to automate GitHub Projects V2 status updates?▼

Yes, you need to configure the GITHUB_WEBHOOK_SECRET environment variable to securely receive GitHub events and route updates to agents for automating GitHub Projects V2 status updates.

Related Skills

Explore More Software Engineering Skills→
zcacereszcaceres
7

snyk

Integrate Snyk security scanning into GitHub repositories via CLI.

Community
Advanced
sandgardenhqsandgardenhq
130

set-workflow-state

Update workflow state files with status, task, and progress via sgai_update_workflow_state.

Official
Intermediate
boengaiboengai
1

HiveBoard GraphQL API

Query and mutate HiveBoard kanban data via GraphQL HTTP and SSE subscriptions.

Community
Advanced
mgd34msumgd34msu
4

graphql

Develop GraphQL APIs with Apollo Server and Apollo Client, covering schemas, resolvers, queries, mutations, and subscriptions.

Community
Advanced