Skip to content

feat: share the PR skill across GitHub and GitLab with a cold read - #45

Merged
MrPointer merged 1 commit into
mainfrom
feat/shared-pr-skill-cold-read
Nov 14, 2026
Merged

MrPointer merged 1 commit into
mainfrom
feat/shared-pr-skill-cold-read

Conversation

@MrPointer

Copy link
Copy Markdown
Owner

📝 Summary

The PR skill only covered GitHub and wrote descriptions from the author's memory of the session. It is now one shared creating-pull-requests skill for GitHub and GitLab, with platform syntax in per-platform reference files. Before writing a description, it has blind reader agents read the diff, so Key Decisions follow what a fresh reviewer finds significant and rationale goes where the diff alone is unclear.

Key Decisions

🧭 Shared Skill with Platform References

The workflow, title format, description sections, and linking rules live in one SKILL.md. Auto-link tokens, emoji syntax, length limits, stacked-PR flags, and the create command live in references/github.md and references/gitlab.md. GitLab targets the public gitlab.com instance.

👀 Cold Read by Blind Agents

The skill stages the branch diff in a scratch file and hands only its path to cheapest-pr-cold-reader, which has just the Read tool and never sees commits, the draft, or session context. Items it marks unclear, or a diff too large for it, go to mid-tier-pr-cold-reader. The two agents share identical instructions but stay separate templates, following the one-template-per-agent pattern in .chezmoitemplates/. Their models follow the repo's existing tier mapping: Haiku and Sonnet on Claude Code, luna and terra on OpenCode.

🥞 Stacked PRs Target Their Parent

A stacked PR now targets the branch directly below it in the stack on both platforms, so its diff shows only its own change. A bundled script infers the nearest parent branch from commit topology when the user does not name it. On GitHub, a closing keyword has no effect until the PR targets the default branch, and the reference says so.

🏷️ Per-Decision Emoji

## Key Decisions stays plain, and each decision heading carries an emoji chosen for that decision instead of one fixed emoji for the whole section.

🔄 Before & After

Area Before After
Platforms GitHub only GitHub and GitLab
Key Decisions source Author's memory Blind cold read of the diff
Stacked PR target Default branch Parent branch
Parent detection Manual Helper script, confirmed when ambiguous
Reader agents None Cheapest and mid-tier readers for Claude Code and OpenCode

The work-grown PR skill had matured past the GitHub-only one: it
checks the diff with blind reader agents before writing the
description, and it handles stacked PRs by targeting the parent
branch. Bring that in as one shared skill with per-platform
references for GitHub and public GitLab, leaving out all
employer-specific tickets, hosts, and URLs.

Add the two cold-reader agents the skill relies on, for both Claude
Code and OpenCode.
@MrPointer
MrPointer merged commit ac39ebb into main Nov 14, 2026
5 checks passed
@MrPointer
MrPointer deleted the feat/shared-pr-skill-cold-read branch November 14, 2026 19:51
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