Index of every page on this site: llms.txt
All skills
jetbrains avatar

/shipping-a-pr

@e85862d
by jetbrainsjetbrains/thinkrail8.4k stars
532
Run it yourself

Use when finished work needs to ship as a pull request, or when creating, syncing, updating metadata, checking status, monitoring CI, or addressing review comments on a PR. Not for reviewing a PR you are not shipping.

Use this Skill: https://skilld.dev/gh/jetbrains/thinkrail/shipping-a-pr

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

screenshots.md

≈709 tokens on demand. Your agent reads this file only when SKILL.md points to it.

screenshots.md — before/after evidence for reviewers

Entry: a PR exists (or was just created) for a UI-visible change. Saves PNGs under .thinkrail/context/pr-shots/ and rewrites the PR body to reference them. Preserve wait mode only when the caller explicitly requested remote completion; otherwise use snapshot mode, including after PR creation.

Capture

  • After = the scenario on the branch build; Before = the same scenario at the base branch (check out detached, rebuild, capture, return). Same viewport, same scenario — the pair must diff visually.
  • Capture with whatever drives the app in this project: the e2e harness with a throwaway capture spec, or a browser-automation session against a running dev host. A capture spec is a throwaway — it never ships, and this doc owns its cleanup (Next below): creating.md's clean-branch gate has already run on every entry path here and will not catch it.
  • Stage the picked shots as .thinkrail/context/pr-shots/<name>.png with names a reviewer reads (loader-before-gap.png, loader-after-working.png).

Attach — review-only assets ref (the default)

Screenshots never enter the PR's file tree. Push them as an orphan ref and reference SHA-pinned URLs:

TREE_INPUT=""
for f in .thinkrail/context/pr-shots/*.png; do
  sha=$(git hash-object -w "$f")
  TREE_INPUT+=$(printf '100644 blob %s\t%s' "$sha" "$(basename "$f")")$'\n'
done
TREE=$(printf '%s' "$TREE_INPUT" | git mktree)
COMMIT=$(printf 'PR screenshots (review-only ref)\n' | git commit-tree "$TREE")
git push -f origin "$COMMIT:refs/heads/assets/<topic>"

Then update the body — never rebuild it: fetch the current one first (gh pr view <n> --json body -q .body > .thinkrail/context/pr-body.md), add or update a ## Screenshots section in it referencing each image as https://github.com/<owner>/<repo>/blob/<COMMIT>/<name>.png?raw=true (pinned to the pushed commit SHA so later branch pushes never break the images), then gh pr edit <n> --body-file .thinkrail/context/pr-body.md. A body built from scratch here would erase the PR's summary, testing notes, and issue links.

Fallback (the user sometimes prefers it): leave the PNGs staged and hand over their paths — the user drags them into GitHub by hand. Offer the choice only when the user has signaled it; the assets ref is the default.

Next

Clean up this phase's capture scaffolds (specs, throwaway builds) once the body edit lands. The staged shots in .thinkrail/context/pr-shots/ and the body file stay: they are the user's artifacts, never deleted by a workflow. If any scaffolding was committed, the commit that removes it is pushed too — a deletion left in the working tree ships nothing. That push does not change the completion mode. Read and follow checks.md in the selected mode.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning22d3 checks · Risk SAFE
  • Gen Agent Trust Hub22d

    The skill provides a structured workflow for managing GitHub Pull Requests, including creation, syncing, and review management. It is functionally appropriate but possesses a vulnerability surface for indirect prompt injection as it processes external content like PR comments and repository templates without explicit sanitization or boundary markers.

  • Socket22d

    No alerts

  • Snyk22d

    Risk: MEDIUM · 1 issue

Signed by skilld at e85862d. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 days ago.

Activeupdated last week

README badge

README badge for jetbrains/thinkrail/shipping-a-pr