SkillsAdd

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.

First seen Mar 9, 2026

Installation

$ npx skills add jackchuka/ghpm --skill ghpm-work
View on skills.sh ↗ GitHub repository ↗

Also in this package

Other skills from jackchuka/ghpm.

npx skills add jackchuka/ghpm
ghpm-init 40 ghpm-suggest 36 ghpm-view 36 ghpm-status 36 ghpm-shared 35 ghpm-issue 24

Browse all from jackchuka/ghpm

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 20
License LICENSE
Default branch main
Open issues 0
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

CompatibilityRequires gh CLI authenticated with read:project and project scopes
Allowed toolsBash(gh:*), Bash(git:*), Read, Write, Edit, Grep, Glob
More metadata
author
jackchuka
scope
generic
confirms
["create git commit","create PR"]

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,370 B
  • docs SUMMARY.md 242 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 38 installs

SKILL.md

ghpm-work

PREREQUISITE: Read ../ghpm-shared/SKILL.md for prerequisites and error handling.

End-to-end workflow for a GitHub Project item. /ghpm-work <issue-number> drives the full lifecycle.

If no argument, ask for the issue number.

Flow

Setup → Clarify → Plan → Implementation Plan → Implement → Draft PR
                    ↕ decisions captured at every phase ↕
Phase Reference What happens
1. Setup references/setup.md Resolve item, assign, branch, status sync, write session
2. Clarify references/clarify.md Evaluate issue clarity, flesh out if needed, gather context
3. Plan references/plan.md Explore codebase, draft approach, post as issue comment
4. Impl Plan references/implementation-plan.md Concrete steps, files, tests — post as issue comment
5. Implement references/implement.md Execute plan, write code, commit, verify
6. Draft PR references/draft-pr.md Create draft PR with summary

Decisions: See references/decisions.md. Capture at ANY phase — not just coding. Watch every interaction for choices worth recording.

Wrap up: See references/wrap-up.md. Triggered by "wrap up" or "done".

Session Resume

Sessions track phase in .ghpm/sessions/<number>.json (schema in ../ghpm-shared/references/session.md).

Each phase writes its phase value to the session file on entry, before doing any work. This means on resume, re-run the recorded phase (it may have been interrupted):

phase Resume from
missing/setup Clarify (setup completed, phase field not yet added)
clarify Clarify
plan Plan
implementation_plan Implementation Plan
implement Implement
pr Draft PR
done Session complete — inform user and stop

On resume, briefly show what's already done before continuing.

Prompt Configuration

Per ../ghpm-shared/references/prompts.md. This skill's config lives at prompts.ghpm-work in .ghpm/config.json.

Action keys: statussync, clarifyissue, postplan, postimplplan, draftpr, record_decision.

Rules

  • Each phase updates "phase" in the session file on entry, before doing any work. This is critical for crash recovery.
  • The user can say "skip" to skip any phase.
  • Multiple sessions can run in parallel on different branches.
  • Restarting Claude on the same branch auto-resumes via session detection.

See Also

  • [ghpm-shared](../ghpm-shared/SKILL.md) — Prerequisites and error handling
  • [ghpm-status](../ghpm-status/SKILL.md) — Project health dashboard
  • [ghpm-suggest](../ghpm-suggest/SKILL.md) — Find what to work on next
  • [ghpm-view](../ghpm-view/SKILL.md) — Query project items