skills.rest
yebot
yebotCOMMUNITY
Explore all skills by this author →
GitHub

project-field-management

Configure and manage GitHub Projects V2 custom fields via CLI.

9|Updated Oct 29, 2025
Search Tags:#workflow#project management#fields#configuration#gh cli#tracking#github projects#custom fields
One-click install
npx skills add https://github.com/yebot/rad-cc-plugins --skill project-field-management
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-field-management
Source: https://github.com/yebot/rad-cc-plugins/tree/main/plugins/github-project-manager/skills/project-field-management
Command: npx skills add https://github.com/yebot/rad-cc-plugins --skill project-field-management

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh.

What problem does it solve?

Effectively configuring and managing custom fields in GitHub Projects V2 is crucial for accurate tracking and reporting, yet it can be complex. This skill provides a comprehensive guide to field types, creation, and management strategies, ensuring your projects are perfectly structured.

Core Features & Use Cases

  • Detailed Field Type Overview: Understand Single Select, Number, Date, Iteration, and Text fields, including their use cases, characteristics, and CLI creation commands.
  • Built-in Fields & Management Strategies: Learn about default fields like Assignees and Labels, and choose between minimal, standard, or comprehensive field sets for your project needs.
  • Field Discovery, Querying & Troubleshooting: Master commands for listing fields, getting IDs, setting values, and resolving common issues like field creation failures or missing options.

Quick Start

To create a new Priority field with options P0 (Critical),P1 (High),P2 (Medium),P3 (Low) for a GitHub Project, ask the skill to "Show me the gh project field-create command to add a SINGLE_SELECT field named 'Priority' with the specified options."

Frequently Asked Questions about project-field-management

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

FAQPage Schema
How do I create custom fields in GitHub Projects V2?▼

Custom fields in GitHub Projects V2 are created using the `gh project field-create` command via CLI or the Projects UI. You specify the field name, type (Single Select, Number, Date, Iteration, or Text), and options if applicable. The CLI command handles field validation and returns the field ID for reference.

What are the different field types available in GitHub Projects, and when should I use each?▼

GitHub Projects V2 supports Single Select (categorize items with predefined options), Number (track quantities or metrics), Date (set deadlines or milestones), Iteration (organize work into sprints), and Text (store free-form data). Choose based on your tracking need: use Single Select for priority or status, Number for estimates, Date for timelines, Iteration for sprint planning, and Text for notes or references.

Can I manage built-in fields like Assignees and Labels in GitHub Projects?▼

Yes, GitHub Projects V2 includes built-in fields such as Assignees and Labels that are available by default. You can choose to use a minimal set (core tracking only), standard set (common fields), or comprehensive set (all available fields) depending on your project's complexity and reporting needs.

How do I troubleshoot field creation failures or missing field options in GitHub Projects?▼

Use `gh project field list` to view all fields and their IDs, and verify field constraints and option formatting before creation. Common issues include malformed option strings or duplicate field names. Consult field validation rules and CLI documentation to resolve errors and ensure options are properly formatted as comma-separated values.

What's the best way to query and retrieve field IDs from my GitHub Project?▼

Use the `gh` CLI commands to list fields in your project and retrieve their IDs programmatically. Field discovery commands allow you to get field metadata, which is essential for setting field values, updating configurations, and automating field management workflows across multiple projects.

Does the gh CLI support updating field values after creation in GitHub Projects?▼

Yes, the `gh` CLI supports setting and updating field values after creation. Once you have the field ID, you can modify field properties, add or remove options, and manage field lifecycle across your GitHub Projects V2 configuration using CLI commands.

Related Skills

Explore More Product & Management Skills→
InverterNetworkInverterNetwork

github-issues

Manage GitHub issue lifecycles via the GitHub CLI or REST API.

Official
Intermediate
victorevhvictorevh

speckit-constitution

Update governance constitution placeholders and generate a Sync Impact Report.

Community
Advanced
junhuajunhua

github-sdlc

Manage GitHub issues, projects, pull requests, releases, and branches.

Community
Advanced
grandcamelgrandcamel
42

jira-custom-fields

Discover and manage Jira custom fields across projects using the jira-as CLI.

Community
Intermediate