Loading...
Loading...
Use right after you open or push to a pull request in a repository Softlight reviews (softlight[bot] comments on its PRs), even if you were only asked to "put up a PR". Opening the PR is not the end of the task. Run the script's --watch in the background and tell the user when the walkthrough is ready (its direct /demo/... link), each issue a check finds, and when the review is complete, even if the PR merges mid-review. The user is whoever you report your work to: the person you're talking with, or another session your instructions name, such as a driver or orchestrator. Also use it instead of building, running or screenshotting the app when someone asks to see or demo a PR's change, or asks for its walkthrough, Softlight video, share or demo link, or what Softlight found. Only ever share the app.softlight.com/demo/... link it returns, never an app.softlight.com/api/softlight/walkthrough/... or /v/... waiting page, even when Softlight's own PR comment links one. Takes a PR URL, owner/repo#number, or a bare number in the current checkout.
npx skill4agent add orianna-ai/skills softlight-walkthroughhttps://app.softlight.com/demo/<owner>/<repo>/pr<number>/<token>get_walkthrough.sh/demo/...app.softlight.com/api/softlight/walkthrough/...app.softlight.com/v/...conductor message create --session <id>| Situation | Do |
|---|---|
| You just opened or pushed to a PR, or were asked to follow it | Watch the review in the background. |
| Someone wants to see a PR's change, or asks for its link | Run |
| You pushed again while a watch on that PR is still running | Leave it running: it follows the review onto the new commit. Don't start another. |
<pr>https://github.com/acme/web/pull/123acme/web#123123acme/web<skill dir>/get_walkthrough.sh --watch <pr>complete:ready: https://app.softlight.com/demo/acme/web/pr123/AbCdEfGhIjKl
commit: 1a2b3c4
issue: P1 desktop — Removing a coupon — Checkout total doesn't update after removing a coupon (on 1a2b3c4)
issue: P2 phone — Removing a coupon — The coupon field is hidden behind the keyboard (on 1a2b3c4)
commit: 9f8e7d6
issue: P1 phone — Opening an empty cart — Empty cart shows a blank page (on 9f8e7d6)
complete: 1 issue found, 17 of 18 checks passed (on 9f8e7d6)| Line | Means | Tell the user |
|---|---|---|
| The walkthrough is published. | It's ready, with the URL on its own line. |
| The review is checking | Nothing the first time. After a push: Softlight has moved on to the new commit. |
| A check found an issue on that device and commit. | The issue (lead with it; |
| The review is over. | It's complete, how many issues and checks passed on that commit, and the link again. |
complete:N of M checks passed0--watchcomplete:1<state>: <why>| State | Means | Do |
|---|---|---|
| The video or the review isn't done yet (or the wait ran out). | Say it's on its way and offer to keep watching. Never hand over a waiting page instead. Don't restart a watch on your own. |
| The review ended without finishing its checks. | Say so in its words, with what it found before then. |
| The PR merged before the video was finished: no walkthrough. | Same as |
| Softlight didn't film this PR. | Say nothing unless the user asked to see the change; then say there's no walkthrough. |
| The video is in the PR description; there's no share page. | Point the user to the PR description. |
| Softlight couldn't say just now. | Run it again in a few seconds. |
2<skill dir>/get_walkthrough.sh <pr> # the link if it's published, else exit 1 at once
<skill dir>/get_walkthrough.sh --wait <pr> # poll for the link, up to 15 minutes (--wait=SECONDS)
<skill dir>/get_walkthrough.sh --watch <pr> # follow the review, up to an hour (--watch=SECONDS)curljqawkgh--wait <pr>--watch <pr>Softlight ReviewSoftlight video · ...details_url/demo/...gh pr checks <n> --repo <owner>/<repo>pull_request_readmethod: get_check_runs/v/...curl -sS https://app.softlight.com/api/softlight/walkthrough/<owner>/<repo>/<number>/status{"state": "ready", "url": "https://app.softlight.com/demo/...", ...}401