Skip to content

docs(gh-skill): document gh issue develop --checkout --worktree - #14265

Merged
babakks merged 1 commit into
trunkfrom
babakks/add-issue-develop-worktree-to-skills
Aug 26, 2026
Merged

docs(gh-skill): document gh issue develop --checkout --worktree#14265
babakks merged 1 commit into
trunkfrom
babakks/add-issue-develop-worktree-to-skills

Conversation

@babakks

@babakks babakks commented Aug 26, 2026

Copy link
Copy Markdown
Member

Description

The gh agent skill (skills/gh/SKILL.md) documents useful gh invocation patterns for agents, including checking a PR out into a git worktree with gh pr checkout <n> --worktree <path>. The equivalent capability for issues, gh issue develop <n> --checkout --worktree <path>, was not documented.

This adds a note covering gh issue develop --checkout and the --worktree flag, including its constraints, so agents know they can create a linked branch for an issue and check it out into a worktree instead of switching the current branch.

How did you test this change?

This is a documentation-only change to a skill Markdown file, so there is no runtime behavior to exercise. I verified the documented flags and constraints against the command source in pkg/cmd/issue/develop/develop.go:

  • --checkout creates and checks out the linked branch.
  • --worktree <path> checks the branch out into a worktree.
  • --worktree requires --checkout, cannot be blank, and is mutually exclusive with --list.

Key points

Placed the new note directly below the existing gh pr checkout --worktree entry in the "Other notes" section to keep the two worktree patterns together.

Notes for reviewers

Start in skills/gh/SKILL.md, "Other notes" section. The wording mirrors the adjacent pr checkout --worktree note for consistency.

Authorship and follow-up

Who wrote this:

  • A human wrote it.
  • An agent wrote it under close human direction.
  • An agent wrote it independently, and no human has guided the implementation beyond the initial prompt.

Who answers review comments:

  • @babakks will read and reply directly.
  • An agent will draft replies and @username will read them before they are posted.
  • Nobody has explicitly committed to replying.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 6377b1fb-b7b7-4ed0-8257-5a68c846a25d
Copilot AI balanced review requested due to automatic review settings August 26, 2026 13:04
@babakks
babakks requested a review from a team as a code owner August 26, 2026 13:04
@babakks
babakks requested a review from BagToad August 26, 2026 13:04

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Documents the worktree workflow for issue-linked branches.

Changes:

  • Adds gh issue develop --checkout --worktree.
  • Documents flag constraints.
Show a summary per file
File Description
skills/gh/SKILL.md Adds the issue worktree guidance.

Review details

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

  • Files reviewed: 1/1 changed files
  • Comments generated: 0
  • Review effort level: Balanced

@babakks
babakks enabled auto-merge August 26, 2026 13:06
@babakks
babakks removed the request for review from BagToad August 26, 2026 13:07
@babakks
babakks merged commit 606cda4 into trunk Aug 26, 2026
21 checks passed
@babakks
babakks deleted the babakks/add-issue-develop-worktree-to-skills branch August 26, 2026 13:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants