A Claude Code skill that gives Claude an
expert-level reference for GitHub Projects (v2): concepts, fields, views, the filter query
language, built-in workflows, Actions automation, insights, the ProjectV2 GraphQL API, and the
gh project CLI.
Distilled from the official documentation at
docs.github.com/en/issues/planning-and-tracking-with-projects/, the GraphQL reference, and the
gh CLI manual (crawled 2026-06-19). Statements the docs do not make are flagged as such rather
than asserted. GitHub ships changes continuously, so spot-check anything load-bearing against the
live docs.
SKILL.md is the always-loaded quick layer: mental model, key limits, the filter-language cheat
sheet, a gh + GraphQL scripting starter, and the gotchas that trip everyone (GITHUB_TOKEN
cannot touch projects, single-select values are set by option ID, --limit silently truncates,
server-side --query filtering beats paginating a whole board).
The reference/ directory holds the deep-dive files, read on demand:
| File | Covers |
|---|---|
01-fundamentals-admin.md |
Concepts, limits, org-vs-user ownership, templates, visibility, access roles |
02-items.md |
Adding items, draft issues, bulk editing, archive vs delete |
03-fields.md |
Every field type, the Status field, built-in fields, org issue fields |
04-views-and-filters.md |
Views, layouts, and the full filter query language |
05-automation.md |
Built-in workflows, auto-add, auto-archive, Actions (with example YAML) |
06-insights.md |
Current vs historical charts, burn up, chart configuration |
07-graphql-and-cli.md |
ProjectV2 GraphQL objects + every mutation, the gh project command table |
08-hierarchy.md |
Sub-issues, parent/child fields, limits, gh CLI, GraphQL + REST |
As a user-level skill (available in every project):
git clone https://github.com/Corvalon/skill-github-projects-v2.git ~/.claude/skills/skill_github-projects-v2Or as a project-level skill:
git clone https://github.com/Corvalon/skill-github-projects-v2.git <your-repo>/.claude/skills/skill_github-projects-v2Claude Code discovers SKILL.md automatically and loads it when a session starts working with
project boards, the ProjectV2 API, or gh project commands.
MIT. See LICENSE.