expo-docs-boxlink-auditlisted
Install: claude install-skill amandeepmittal/expo-docs-skills
# Expo Docs BoxLink Audit
**Single concern: icon mismatches only.** This skill does not check BoxLink title length, description presence, href format, or any other style rule. Those are handled by the broader `expo-docs-review` skill.
## Input
A public GitHub PR URL. Accepted forms:
- `https://github.com/expo/expo/pull/30000`
- `expo/expo#30000`
- A bare PR number, when the user has already established the repo in context
## References
- **`references/expo-docs-boxlink-icons.md`** — canonical destination→icon mapping, severity guidance, special-case exceptions.
## Four-phase workflow
### Phase 1: Fetch and Context
Use the `gh` CLI for all GitHub fetches.
1. **Resolve the PR.** Parse `{owner}/{repo}/{number}` from the user's input.
2. **Fetch PR metadata:**
```sh
gh pr view {number} --repo {owner}/{repo} --json title,body,baseRefOid,headRefOid,author,files
```
3. **Fetch the diff:**
```sh
gh pr diff {number} --repo {owner}/{repo}
```
Parse the unified diff. Build the list of `.mdx` files under `docs/pages/` that the PR changes. Note added vs. modified vs. removed lines per file.
4. **For each changed `.mdx` file, fetch the head-version content:**
```sh
gh api 'repos/{owner}/{repo}/contents/{path}?ref={head_sha}' \
-H "Accept: application/vnd.github.raw"
```
5. **Read the PR title and body.** Skip files where the PR's scope clearly excludes BoxLink work (e.g. a typo fix PR that does not touch components).
### Phase 2: Analyze