Open draft pr
Use in /implement after committing, to push the feature branch and open a draft PR, returning the PR ref. Thin and GitHub-specific (gh) behind a host-neutral contract. Transitional — removed under the post-v1 flow simplification. Project-overridable for provisioning-heavy open steps.From its SKILL.md
npx -y skills add ethanaubuchon/dossier-tradecraft --skill open-draft-prAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
- runs commandsInstructs the agent to run 3 commands, including `git push -u origin <branch>` and 2 more.
SKILL.md
2.3 KB, 512 tokens by cl100k_base, as published. Nobody here has run it
Open Draft PR
Opens the draft PR that /implement's review step runs inside. Thin: push the branch, create a draft PR, return its ref. The PR is a draft (not ready) so review happens before it's "real" — and so pr-review-toolkit's PR-framed agents (when used via the agent-review ceiling) have a PR object to attach to.
All GitHub/gh coupling lives here and in publish-pr; the recipe and the other primitives stay host-agnostic.
Input
- branch — the feature branch (from
repo-setup), already committed. - title, body — composed by the recipe from the
plan-file/ ticket.
Steps
- Push the branch and set upstream if it isn't on the remote yet:
git push -u origin <branch>. - Idempotency — if a PR already exists for this branch (
gh pr list --head <branch>returns one), return its ref instead of creating a duplicate (gh pr createerrors when one exists). - Open a draft PR:
gh pr create --draft --title "<title>" --body "<body>"— base = the repo's default branch, head = the current branch (ghinfers both; pass--base/--headexplicitly if those defaults don't apply). Add per-repo flags (labels, reviewers) per the project's agent-instruction file. - Capture and return the PR ref (number + URL) from the
ghoutput.
Output / contract
- In: a committed branch + PR title/body.
- Out: the draft PR ref (number/URL), surfaced so
agent-reviewandpublish-prcan target it. - Side effects: pushes the branch (network write); creates a draft PR. Nothing merged or marked ready.
Project overrides
- Provisioning-heavy open steps — a repo with a scripted opener (e.g. domainator's
create-pr.sh: templated body, labels, linked issues) overrides this, keeping the contract (branch → PR ref).
Future scope
- Transitional. Under the post-v1 flow simplification (review the branch directly, no draft PR), this primitive is removed and
publish-prabsorbs PR creation. Keep it thin so its removal is cheap.
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.