Files
stack/packages/mosaic/framework/skills/pr-reviewer/references/troubleshooting.md
fargo 1a822493ba format: apply repo prettier (3.8.1) to the folded skills tree
963 markdown files reformatted with the repository's pinned prettier so
pnpm format:check covers the folded tree like every other repo file.

The formatter's embedded-language pass also normalized code fences
(TS semicolons, closed HTML tags in examples, lowercased CSS hex colors,
one renumbered list that skipped an index). Alphanumeric token deltas vs
the fold commit were audited file-by-file; all are formatter-equivalent
markup normalizations plus the four sanitized skills.
2026-08-19 14:37:17 -05:00

1.2 KiB

Troubleshooting Guide

Common issues and solutions for the PR Reviewer skill.

gh CLI Not Found

Install GitHub CLI: https://cli.github.com/

# macOS
brew install gh

# Linux
sudo apt install gh  # or yum, dnf, etc.

# Authenticate
gh auth login

Permission Denied Errors

Check authentication:

gh auth status
gh auth refresh -s repo

Invalid PR URL

Ensure URL format: https://github.com/owner/repo/pull/NUMBER

Line Number Mismatch in Diff

Inline comment line numbers are relative to the diff, not absolute file positions. Use gh pr diff <number> to see diff line numbers.

Rate Limit Errors

# Check rate limit
gh api /rate_limit

# Authenticated users get higher limits
gh auth login

Common Error Patterns

Error Cause Solution
401 Unauthorized Token expired Run gh auth refresh
403 Forbidden Missing scope Run gh auth refresh -s repo
404 Not Found Private repo access Verify repo permissions
422 Unprocessable Invalid request Check command arguments