Shared reference for all ghpm skills — prerequisites, config format, startup sequence, and error handling.
Shared reference for all ghpm skills — prerequisites, config format, startup sequence, and error handling.
npx skills add https://github.com/jackchuka/ghpm --skill ghpm-shared复制此命令并粘贴到 Claude Code 中以安装该技能
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.
Initialize GitHub Project Management config. Auto-discovers project schema (fields, views, repos) and generates .ghpm/config.json + .ghpm/cache.json.
GitHub Project health dashboard. Shows workflow distribution, component health, team workload, items needing attention, and available views.
Suggest what to work on next based on project state and session context. Considers proximity, momentum, status, and constraints.
Query GitHub Project items by named view or ad-hoc filter. Shows items in board, table, or roadmap format.
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.
| name | ghpm-shared |
| description | Shared reference for all ghpm skills — prerequisites, config format, startup sequence, and error handling. |
| compatibility | Requires gh CLI authenticated with read:project and project scopes |
| metadata | {"author":"jackchuka","scope":"generic"} |
gh CLI installed and authenticatedread:project, projectAll ghpm files live under .ghpm/:
| File | Purpose |
|---|---|
.ghpm/config.json | Project config (fields, views, repos) |
.ghpm/cache.json | Cached project items |
.ghpm/sessions/<number>.json | Active work session per issue |
The entire .ghpm/ directory is gitignored (project-specific).
If .ghpm/config.json is missing, tell the user to run /ghpm-init first and stop.
Every skill that reads project data should follow this sequence:
.ghpm/config.json from the current directory. If missing, stop with init guidance (above).references/cache.md. If the cache is stale or missing, automatically re-fetch — no user prompt needed. If the re-fetch fails (network error, rate limit), fall back to the stale cache if available and note the age inline (e.g., "Using cached data from 2 hours ago")..ghpm/sessions/*.json. For each session file, read started_at and compare to now. If a session is older than 24 hours, prompt the user:
Found stale session for #<num> "<title>" (started <N> days ago).
Wrap up and post journal, or discard?
ghpm-work (gather git context, post journal, clear session).gh auth status fails): tell the user to run gh auth login and stop.read:project, project).Skills that modify project items are write operations. Whether to confirm with the user is controlled by prompts config — see references/prompts.md for resolution logic.
Default behavior (no config): always prompt.
Optional hooks/rules enhance ghpm-work sessions (auto session context, stale session detection). See references/integrations.md for details. Installed by /ghpm-init when an agent is detected. Without hooks, all skills work via explicit commands.
| Skill | Purpose |
|---|---|
ghpm-init | Initialize config from GitHub Projects v2 |
ghpm-status | Project health dashboard |
ghpm-view | Query items by view or ad-hoc filter |
ghpm-suggest | Context-aware work recommendations |
ghpm-work | Start a work session on an issue |
ghpm-issue | File an issue and add to project |