feat: add github-projects skill — Project v2 board administration 🤖🤖🤖 - #2686
Open
surapuramakhil wants to merge 1 commit into
Open
feat: add github-projects skill — Project v2 board administration 🤖🤖🤖#2686surapuramakhil wants to merge 1 commit into
surapuramakhil wants to merge 1 commit into
Conversation
… gh CLI Covers board administration beyond item ops: project creation, the evergreen-board pattern (releases as a Release field option + filtered view, not per-release projects), single-select field/option management, view creation, and idempotent release-cycle seeding with a bundled reference script. Documents API walls verified live against the GraphQL schema: - camelCase input keys that differ per mutation (fieldId vs projectId) - every singleSelectOption requires name + color + description (full color enum included) - singleSelectOptions replaces the full option list — merge semantics - view grouping/filter and workflow automation are UI-only (no updateProjectV2Workflow in schema) - gh project item-edit needs --project-id AND --id; prints empty stdout on success (scripting pitfall) Complements the github-issues skill's Projects V2 reference, which covers item add/update but not board administration.
github-actions
Bot
added
new-submission
Contributor
🔒 PR Risk Scan ResultsScanned 2 changed file(s).
|
Contributor
🔍 Vally Lint Results✅ All checks passed
Summary
Full linter output |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this adds
A skill for administering GitHub Projects (v2) boards — the setup/config layer that sits above item management.
Why (the gap)
The existing
github-issuesskill's Projects V2 reference covers item operations (add/update items, find projects, set field values) but not board administration. This skill covers the rest, dogfooded end-to-end on a real org board (fields + options + two views + 13-issue seed, executed via these exact commands):Releasesingle-select option + filtered view — not a per-release projectVerified API walls (schema-introspected, live-tested 2026-08)
These are the things that reliably trip agents up:
updateProjectV2FieldtakesfieldId;createProjectV2ViewtakesprojectId;gh project item-editneeds both--project-idand--idsingleSelectOptionrequiresname+color+description; enum has no TEAL/MAGENTAsingleSelectOptionsreplaces the full list — merge before sendingupdateProjectV2Workflowdoesn't exist) — one-time web-UI stepsgh project item-editprints empty stdout on success — scripting pitfallValidation
npm run skill:validate→✅ github-projects is valid(all 409 skills pass)npm run buildrun;docs/README.skills.mdregeneratedmain(notstaged) per CONTRIBUTING