Skip to content

Add the gh-stack skill for stacked pull requests - #156

Merged
molefrog merged 1 commit into
mainfrom
docs/gh-stack-skill
Oct 9, 2026
Merged

molefrog merged 1 commit into
mainfrom
docs/gh-stack-skill

Conversation

@molefrog

@molefrog molefrog commented Oct 7, 2026 •

Copy link
Copy Markdown
Owner

Vendors GitHub's official gh-stack agent skill into .agents/skills/gh-stack/, with the .claude/skills/gh-stack symlink this repo uses to expose skills to Claude Code. Agents working here now know how to create, view, submit, sync, rebase, and merge stacked pull requests with the gh stack CLI extension, including the flags that keep it from opening a TUI under an agent harness.

It was installed through the skills.sh CLI so the source and content hash land in skills-lock.json next to the existing shadcn entry, which is what bunx skills update and experimental_install use to refresh or restore it. The content is verbatim upstream v0.2.0.

bunx skills add github/gh-stack --skill gh-stack --agent claude-code --agent codex -y

This PR is itself layer 3 of stack #155, created with the skill's own workflow (gh stack checkout 152, gh stack add docs/gh-stack-skill, gh stack submit --auto --open, then gh stack push after the amend):

(main) <- tinkering/view-chats (#151) <- tinkering/chat-links (#152) <- docs/gh-stack-skill (#156)

Worth a close look:

  • The skill is unrelated to the two PRs below it; it sits on top only to exercise the stacking feature. Stack membership is additive, so merging it on its own means unstacking #155, rebasing docs/gh-stack-skill onto main with base main, then re-linking the other two with gh stack link 151 152.
  • The .claude/skills symlink is load-bearing, not decorative. Claude Code 2.1.292 only scans .claude/skills; a probe skill left in .agents/skills/ without a symlink was never discovered, and was picked up on the next tool call once the symlink existed.
  • The vendored files are verbatim upstream content (SKILL.md plus three references). .agents is in the .oxfmtrc.json ignore list, so the pre-commit formatter leaves them alone and the lock hash stays valid.

Verified: all four vendored files reviewed for injected instructions or scripts (none; official GitHub content, and skills.sh's Socket and Snyk scans report no alerts), SKILL.md resolves through the symlink and appears in Claude Code's skill list, gh stack view --json reports three layers with PRs #151, #152, #156, and the commit hook ran lint and format without touching the vendored files.

🤖 Generated with Claude Code

@molefrog
molefrog added this pull request to stack #155 October 7, 2026 13:24
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 7, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-07T13:27:14.166972Z 78f4597 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@molefrog
molefrog force-pushed the docs/gh-stack-skill branch from 78f4597 to 18d767d Compare October 7, 2026 13:38
Base automatically changed from tinkering/chat-links to main October 9, 2026 12:36
Vendor GitHub's official `gh-stack` agent skill into `.agents/skills/gh-stack/` so agents in this
repo know how to create, view, submit, sync, rebase, and merge stacked pull requests with the
`gh stack` CLI extension, including the non-interactive flags that keep it from opening a TUI.

Installed with the skills.sh CLI (`bunx skills add github/gh-stack`), which records the source and
content hash in `skills-lock.json` next to the existing shadcn entry, keeps the canonical copy in
`.agents/skills/` for Codex, and symlinks `.claude/skills/gh-stack` for Claude Code per the repo
convention. Content is verbatim upstream v0.2.0.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@molefrog
molefrog force-pushed the docs/gh-stack-skill branch from 3f7feed to 6828b23 Compare October 9, 2026 12:40
@molefrog
molefrog merged commit 7d25425 into main Oct 9, 2026
1 check passed
@molefrog
molefrog deleted the docs/gh-stack-skill branch October 9, 2026 12:41
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.

1 participant