github-projects

Automate GitHub Projects V2 creation and management via GraphQL.

Updated Jan 15, 2026
One-click install
npx skills add https://github.com/arbgjr/smart_alarm --skill github-projects-arbgjr
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: github-projects
Source: https://github.com/arbgjr/smart_alarm/tree/main/.claude/skills/github-projects
Command: npx skills add https://github.com/arbgjr/smart_alarm --skill github-projects-arbgjr

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill includes scripts (resource) components.

What problem does it solve?

This skill automates the creation and ongoing management of GitHub Projects V2 via GraphQL, enabling SDLC teams to standardize project setup and lifecycle automation.

Core Features & Use Cases

  • Create and manage GitHub Projects V2 via GraphQL and gh CLI.
  • Configure SDLC-specific fields (Phase, Priority, Story Points) and associated views.
  • Add and update issues within projects, and generate actionable dashboards.
  • Use Case: Initialize a new feature with a dedicated project, assign related issues, and move items through phases automatically.

Quick Start

Ensure GitHub CLI (gh) is installed and authenticated. Create a new project: python3 .claude/skills/github-projects/scripts/project_manager.py create --title "SDLC: Feature X" --description "Projeto para feature X" Configure fields: python3 .claude/skills/github-projects/scripts/project_manager.py configure-fields --project-number 1 Add an existing issue: python3 .claude/skills/github-projects/scripts/project_manager.py add-item --project-number 1 --issue-url "https://github.com/owner/repo/issues/123" Update a field value: python3 .claude/skills/github-projects/scripts/project_manager.py update-field --project-number 1 --item-id "PVTI_xxx" --field "Phase" --value "In Progress" List your projects: python3 .claude/skills/github-projects/scripts/project_manager.py list Optional: create a Kanban view: python3 .claude/skills/github-projects/scripts/project_views.py create-kanban --project-number 1

Frequently Asked Questions about github-projects

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

FAQPage Schema
How do I automate GitHub Projects V2 creation and management via GraphQL?โ–ผ

Automating GitHub Projects V2 involves running Python scripts that interact with the GitHub GraphQL API to create projects, configure custom fields, manage views, and sync issues. This skill provides scripts to handle these SDLC workflow tasks automatically.

What do I need to set up before using scripts to manage GitHub Projects V2?โ–ผ

Before managing GitHub Projects V2, you need the GitHub CLI (gh) installed and authenticated with project scope, a Python 3 environment, and authenticated access to interact with the GitHub GraphQL API.

Can I configure custom fields like Story Points and Phase in GitHub Projects V2?โ–ผ

Yes, you can configure SDLC-specific custom fields including Phase, Priority, and Story Points in GitHub Projects V2. The skill provides a configure-fields command to set up these fields and associated views for your project.

How do I add an existing GitHub issue to a Project V2 and update its field values?โ–ผ

To add an existing issue to a GitHub Project V2, use the add-item command with the project number and issue URL. Then, update its field values using the update-field command with the item ID, field name, and new value to sync issues across SDLC phases.

What's the best way to create a Kanban view for a GitHub Projects V2 board?โ–ผ

The best way to create a Kanban view for a GitHub Projects V2 board is using the project_views.py script with the create-kanban command and the project number. This sets up a visual board for tracking issues through SDLC phases.

Does this GitHub Projects automation work without the GitHub CLI?โ–ผ

No, this GitHub Projects V2 automation requires the GitHub CLI (gh) to be installed and authenticated with project scope. The scripts depend on the gh CLI to authenticate and interact with the GitHub GraphQL API for managing projects.