GitHub Projects v2 Skill for Openclaw

An AI agent skill designed to seamlessly manage GitHub Projects v2 backlogs, status updates, and issue lifecycles via the GitHub CLI.

freddydk
v1.0.0
Jun 5, 2026
3
510
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install git-hub-projects-v2

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install git-hub-projects-v2 using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is GitHub Projects v2 Skill?

The GitHub Projects v2 skill equips your AI development agent with the specialized capacity to programmatically manage boards, task backlogs, and fields directly through the official gh CLI. By interfacing seamlessly with GitHub's robust modern project architecture, this skill bridges the gap between active code changes and project management tracking.

Using this skill within the Openclaw Skills ecosystem allows AI agents to dynamically triage incoming tickets, modify issue parameters, structure sprint timelines, and link child issues to epic milestones without forcing human context switching. It serves as an essential component for teams looking to automate routine agile ceremonies and project board grooming workflows.

GitHub Projects v2 Skill Use Cases

  • Triage and filter open issues assigned to specific developers or milestones directly from the terminal.
  • Dynamically update project field statuses, iterations, story points, and custom field values based on development progress.
  • Automate issue tracking by automatically creating issues, appending them to a specified project board, and injecting progress updates via comments.
  • Construct parent-child issue relationships for detailed epic and sub-task breakdown tracking.

How GitHub Projects v2 Skill Works

  1. Authentication Verification: The agent checks authentication status and requests the necessary project scopes via the GitHub CLI.
  2. Target Node Discovery: The skill fetches the specific project and item node GraphQL IDs needed for structural modifications.
  3. Querying and Filtering: The skill queries existing backlogs using target filters such as status, assignments, or custom metadata fields.
  4. Mutation Implementation: The skill updates fields, alters select values, changes status columns, or appends external issue URLs.
  5. Relationship Linkage: The skill leverages CLI extensions or raw GraphQL API calls to build structural hierarchy via sub-issues.

GitHub Projects v2 Skill Setup

Ensure you have the GitHub CLI (gh) installed and authenticated. This skill requires the project scope to manage v2 boards.

# Verify your current authentication status and scopes
gh auth status

# Refresh your authentication tokens to append the required project scope
gh auth refresh -s project

# (Optional) Install the sub-issue extension if managing issue hierarchies
gh extension install yahsan2/gh-sub-issue

GitHub Projects v2 Skill Data Schema & Taxonomy

The skill manages parameters using identification tokens and structured CLI outputs. Understanding how data maps between human-readable numbers and backend GraphQL nodes is vital:

Data Component CLI Reference Type Formats / Examples Purpose
Project Number Short Identifier (Integer) 1, 42 Used for standard project board actions
Project ID GraphQL Node ID PVT_kwDOA... Required for item-edit mutations
Item Node ID GraphQL Node ID PNI_lADOA... Uniquely references a single item inside a board
Field Node ID GraphQL Node ID PVTF_lADO... References configuration schema like Status or Priority

GitHub Projects v2 Skill Advanced Features

  • Granular Item Editing: Programmatically manipulates Single-Select, Iteration (Sprint), Date, and Number fields across items.
  • Sub-Issue Hierarchy Support: Orchestrates native parent-child issue mappings using advanced GraphQL mutations or CLI extensions.
  • JSON Output Integration: Streamlines downstream scripting and data processing pipelines by generating raw JSON payload responses paired with jq parsing.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*