github-pr

GitHub PR Comments Skill

Post user testing results as GitHub PR comments for CI/CD integration.

When to Use

• Running tests in CI/CD pipelines
• Automated testing on PR preview deployments
• Sharing test results with reviewers
• Tracking UX regressions across PRs

Prerequisites

• gh CLI installed and authenticated
• In GitHub Actions: GITHUB_TOKEN is automatically available
• PR write permissions (pull-requests: write)

Flag

--pr <number>     Post results as comment on PR #<number>

Comment Format

Structure

<!-- user-test-results:[persona-id] -->
## User Test Results: [Persona Name]

**Status:** [badge] | **Tested:** [timestamp]

| Metric | Value |
|--------|-------|
| URL | `https://...` |
| Persona | [name] ([id]) |
| Viewport | [viewport] |
| Network | [network] |
| Duration | [duration]s |

### Summary
- Tasks: X/Y completed
- Critical Issues: N
- Major Issues: N
- Minor Issues: N

<details>
<summary>Issues Found (N)</summary>

#### Critical
...

#### Major
...

#### Minor
...

</details>

<details>
<summary>Screenshots</summary>

[Links to screenshots/trace if --record used]

</details>

---
*Tested with [user-testing-agent](https://github.com/ncklrs/claude-chrome-user-testing)*

Status Badges

Status	Badge	When
Pass	PASS	All tasks completed, no critical issues
Fail	FAIL	Critical issues found or tasks failed
Issues	ISSUES	Tasks completed but major/minor issues exist

Posting Logic

Simple Post

gh pr comment $PR_NUMBER --body "$COMMENT_BODY"

Update Existing (Recommended)

Prevents comment spam on re-runs by updating existing comment:

# Marker includes persona ID to allow multiple persona comments
MARKER="<!-- user-test-results:$PERSONA_ID -->"

# Check for existing comment with this marker
EXISTING=$(gh pr view $PR_NUMBER --json comments \
  --jq ".comments[] | select(.body | contains(\"$MARKER\")) | .databaseId" \
  | head -1)

if [ -n "$EXISTING" ]; then
  # Update existing comment
  gh api repos/{owner}/{repo}/issues/comments/$EXISTING \
    -X PATCH \
    -f body="$COMMENT_BODY"
  echo "Updated existing comment"
else
  # Create new comment
  gh pr comment $PR_NUMBER --body "$COMMENT_BODY"
  echo "Created new comment"
fi