Create a GitHub PR for FlashList. Ensures no AI/Claude attribution in commits or PR body, follows repo conventions for title, description, and test plan.
Prerequisite: Run the review-and-test skill first. All checks must pass and device testing must be done before raising a PR. DO NOT SKIP.
main — always create a branch and open a PR.Co-Authored-By AI lines. The PR must read as if written entirely by a human.Before creating the branch and PR, kill any background processes you started (Metro, emulators, etc.). On CI, leftover processes prevent the GitHub Actions job from exiting.
lsof -ti:8081 | xargs kill -9 2>/dev/null || true
fix/issue-<number>-<short-slug>
feat/<short-slug>
refactor/<short-slug>
fix(<scope>): <concise description>
Fixes #<number>
Scope examples: layout, hooks, scroll, sticky-headers, recycling, viewability.
Do NOT include:
Co-Authored-By linesGenerated by or Assisted by attributionsgit checkout -b fix/issue-<number>-<short-slug>
git add <specific files>
git commit -m "$(cat <<'EOF'
fix(<scope>): <description>
Fixes #<number>
EOF
)"
git push -u origin fix/issue-<number>-<short-slug>
Run git diff HEAD~1 and check for:
console.log, fetch("http://localhost:..."), temporary commentsCo-Authored-By lines — check with git log -1 --format=fullindex.js left with forceRTL(true) — always revert before committingQuick check:
grep -r "console\.\(log\|warn\)\|localhost:9876\|forceRTL(true)" src/ fixture/react-native/index.js --include="*.ts" --include="*.tsx" --include="*.js"
Fix any issues found, then amend the commit before proceeding.
fix(<scope>): <description>Always use --body-file — inline --body with markdown # headers triggers Claude Code permission checks and wastes turns. Use the Write tool to create the file (not cat, echo, or touch, which may be blocked by sandbox on CI).
Write the following to /tmp/pr-body.md using the Write tool:
## Description
<1-3 sentences: what the bug was and how the fix works>
Fixes #<number>
## Reviewers' hat-rack :tophat:
<What reviewers should focus on — layout logic, hook behavior, edge cases, etc.>
## Screenshots or videos
<Before/after screenshots if applicable>
## Test plan
- [ ] Unit tests pass (`yarn test`)
- [ ] Type check passes (`yarn type-check`)
- [ ] Lint passes (`yarn lint`)
- [ ] Verified on iOS simulator
- [ ] No regressions on related screens
EOF
GH_TOKEN="$AGENT_PR_TOKEN" gh pr create \
--title "fix(<scope>): <description>" \
--body-file /tmp/pr-body.md
CRITICAL — TOKEN VERIFICATION (read this before running
gh pr create)
- First, verify the token is available:
[ -n "$AGENT_PR_TOKEN" ] && echo "token ok" || echo "TOKEN MISSING"— do NOT echo the token value itself.- You MUST use
GH_TOKEN="$AGENT_PR_TOKEN" gh pr create ...— never baregh pr create.- PRs created with the default
GITHUB_TOKENshow asapp/github-actionsand cannot be merged.- After creating the PR, verify the author:
gh pr view --json author --jq '.author.login'— it must NOT beapp/github-actions.If
AGENT_PR_TOKENis empty, trySHOPIFY_GH_ACCESS_TOKENas fallback:GH_TOKEN="${AGENT_PR_TOKEN:-$SHOPIFY_GH_ACCESS_TOKEN}" gh pr create ...
Before running gh pr create, double-check:
Return the PR URL to the user.
If the user asks to update the PR (interactive only — not available on CI):
git add <files>
git commit --amend --no-edit
git push --force-with-lease
On CI, create a new commit instead of amending — force-push is not permitted.