skills.rest
kynoptic
kynopticCOMMUNITY
Explore all skills by this author →
GitHub

Managing GitHub Projects

Automate GitHub Project V2 item and custom field updates via GitHub CLI.

1|Updated Jun 4, 2025
Search Tags:#automation#workflow#cli#projects#gh
One-click install
npx skills add https://github.com/kynoptic/markdownlint-trap --skill managing-github-projects
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Managing GitHub Projects
Source: https://github.com/kynoptic/markdownlint-trap/tree/main/.claude/skills/gh-project-manage
Command: npx skills add https://github.com/kynoptic/markdownlint-trap --skill managing-github-projects

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manages GitHub Projects V2 items and custom fields using GitHub CLI commands. Use when adding issues/PRs to projects, updating Status (Backlog/Todo/Doing/Done), Value (Essential/Useful/Nice-to-have), or Effort (Light/Moderate/Heavy) fields, querying project data, or performing bulk operations.

Core Features & Use Cases

  • Add item to project: gh project item-add <project-number> --owner <org> --url <issue-url>
  • List fields & items: gh project field-list, gh project item-list
  • Update item fields: gh project item-edit with single-select or text values
  • Project configuration: Discover project IDs and field IDs, manage bulk updates

Quick Start

Example: Add issue #123 to project 1 for owner kynoptic.

Frequently Asked Questions about Managing GitHub Projects

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

FAQPage Schema
How do I add issues and pull requests to GitHub Projects using the CLI?▼

Use `gh project item-add <project-number> --owner <org> --url <issue-url>` to add items to GitHub Projects V2. The command requires your project number, repository owner, and the full URL of the issue or pull request you want to add.

Can I automate status and custom field updates across multiple GitHub Project items?▼

Yes, use `gh project item-edit` to update Status, Value, Effort, and other custom fields on individual or bulk items. You'll need the item ID, field ID, and the appropriate value type—single-select option IDs for Status/Value/Effort, text, date, or number values.

How do I find project IDs and field IDs in GitHub Projects V2?▼

Run `gh project field-list` to discover all custom fields and their IDs in your project, and `gh project item-list` to view project items. These commands return the field IDs and item IDs you need for update operations.

What's the best way to sync GitHub Project items with external workflows?▼

Automate item synchronization and field updates using GitHub CLI commands in scripts or CI/CD pipelines. Query project data with `gh project` commands, then perform bulk updates by looping through item and field IDs with `item-edit` operations.

Do I need special permissions to manage GitHub Projects V2 through the CLI?▼

You need GitHub CLI installed and authenticated, plus appropriate repository and project permissions in GitHub. The `gh` tool handles authentication; ensure your account has write access to the projects and repositories you're managing.

Related Skills

Explore More Software Engineering Skills→
TasupTasup
2

update-issue-status

Update GitHub Issue statuses across linked Projects V2 via gh project item-edit.

Official
Advanced
semicolon-devteamsemicolon-devteam

report-test-result

Report test results to GitHub Projects, issue comments, and Slack.

Official
Advanced
danmestasdanmestas
4

gh-project-operations

Automate GitHub Projects V2 issue CRUD and project item management via gh CLI.

Community
Intermediate
JuanMS20JuanMS20

linear

Executes Linear GraphQL queries and mutations via curl to manage projects and tasks.

Community
Intermediate