Claude Plan Skills

claude-plan-skills

Custom [Claude Code](https://claude.ai/code) skills for managing work across sessions using GitHub issues as execution plans.

The problem

Claude Code starts fresh every session. Complex tasks that span multiple conversations lose their thread: what's been done, what decisions were made, what's still pending.

The solution

Use a GitHub issue as a persistent plan:

Skill	What it does
/gh-create-plan	Creates a structured GitHub issue with steps, design, diagram, links, and agent sessions as separate comments
/gh-read-plan	Reads the issue, identifies completed and pending steps, and briefs the session
/gh-implement-plan	Works through steps in order, commits after each step, checks off checkboxes
/gh-update-plan	Updates the issue with progress, tracks which agent sessions worked on it. Supports --preview (diff before uploading)
/gh-close-plan	Consolidates session logs, captures learnings, finalizes PRs table, and closes
/gh-create-pr	Creates a PR using --web to open the browser with title and body pre-filled for editing
/handover	Prepares a handover prompt for continuing work in a new session

A new conversation can pick up exactly where the last one left off by reading the issue with `/gh-read-plan`, or by pasting a `/handover` prompt from the previous session.

Installation

Copy the skill directories into your Claude Code skills folder:

cp -r gh-create-plan gh-read-plan gh-implement-plan gh-update-plan gh-close-plan gh-create-pr handover ~/.claude/skills/

Or clone and symlink (recommended — picks up new skills on `git pull`):

git clone https://github.com/gjoranv/claude-plan-skills ~/git/claude-plan-skills
for d in ~/git/claude-plan-skills/*/SKILL.md; do
  ln -sfn "$(dirname "$d")" ~/.claude/skills/
done

Codex

These skills are agent-neutral and work with Codex. Copy them to the Codex skills folder:

cp -r gh-create-plan