ghpm-init
ghpm-init
PREREQUISITE: Read
../ghpm-shared/SKILL.mdfor prerequisites and error handling.
Initialize a GitHub Projects v2 project for use with ghpm skills. Auto-discovers schema and generates config files.
Arguments
- Project URL (e.g.,
https://github.com/orgs/<org>/projects/<number>) - If no arguments, ask the user for the project URL or owner + number.
Workflow
Phase 1: Validate Access
- Parse arguments to extract owner and project number from URL or positional args.
- Run
gh auth statusto verify authentication. If this fails, tell the user to rungh auth loginand stop. - Run
gh project view <number> --owner <owner> --format jsonto verify access and get project metadata (id, title). If this fails with 403/404, tell the user to check token scopes (read:project,project) and project access. - Determine the owner type from the project view output. This matters for Phase 3: use
organization(login: "<owner>")for org-owned projects oruser(login: "<owner>")for user-owned projects.
More from jackchuka/ghpm
ghpm-work
End-to-end work session on a GitHub Project item. Setup → Clarify → Plan → Implement → PR, with decisions captured throughout. Use when starting work on an issue, picking up a task, or resuming an interrupted session.
30ghpm-status
GitHub Project health dashboard. Shows workflow distribution, component health, team workload, items needing attention, and available views.
29ghpm-suggest
Suggest what to work on next based on project state and session context. Considers proximity, momentum, status, and constraints.
29ghpm-view
Query GitHub Project items by named view or ad-hoc filter. Shows items in board, table, or roadmap format.
28ghpm-shared
Shared reference for all ghpm skills — prerequisites, config format, startup sequence, and error handling.
28ghpm-issue
File a GitHub issue and add it to the project board. Works mid-session or standalone. Reads .ghpm/config.json for repo list and project.
15