External pr review

Skill postmelee/hyper-waterfall/templates/locales/en/mydocs/skills/external-pr-review

A human-governed AI coding workflow that distills ephemeral session context into persistent project memory—making work traceable, reviewable, and resumable.

Install

npx -y skills add postmelee/hyper-waterfall --skill external-pr-review

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

Apply the external contributor PR review procedure. Collect PR information, write mydocs/pr/pr_{N}_review.md, verify, write pr_{N}_report.md, and move documents to archives/ when processing is complete. Use only for external contributor PRs, not internal tasks.

SKILL.md

3.7 KB, as published. Nobody here has run it

External Contributor PR Review

Trigger

The task requester explicitly says "review PR #N" or "review external PR."
This SKILL is invoked directly.

Preconditions

The PR under review is opened from an external contributor fork to this repository's {BASE_BRANCH} or agreed base.
Do not use this SKILL for internal task PRs such as publish/task{N}. Internal tasks use the normal stage procedure.
gh CLI authentication is available.

Procedure

Collect PR metadata.

gh pr view {N} --json number,title,state,baseRefName,headRefName,headRepository,mergeable,mergeStateStatus,reviewDecision,labels,body
gh pr diff {N} | head -200
gh pr checks {N}

Check linked Issues, base/head, mergeability, and CI state.

Write review document: mydocs/pr/pr_{N}_review.md.
- Use central template mydocs/_templates/external_pr_review.md.
- Only if the template cannot be read, use these fallback sections:
  - PR information: number, author, base/head, linked Issue
  - Change summary
  - Impact area and compatibility: FFI, build, documentation
  - Code/documentation review findings
  - Verification plan
  - Recommendation: merge / request changes / close
  - Approval request to task requester
Request task requester approval for the review direction.
If needed, write a modification/verification plan: mydocs/pr/pr_{N}_review_impl.md.
- Use central template mydocs/_templates/external_pr_review_impl.md.
- Use this only when this repository needs additional verification work.
- Request approval after writing it.
Run verification only when applicable.
- Apply {PROJECT_VALIDATION_GUIDE} based on change type.
Write final report: mydocs/pr/pr_{N}_report.md.
- Use central template mydocs/_templates/external_pr_report.md.
- Include review result, verification result, final recommendation, and GitHub PR comment body or link.
After task requester approval, post the comment or review to the GitHub PR. The task requester decides merge.

When processing is complete, archive documents.

git mv mydocs/pr/pr_{N}_review.md mydocs/pr/archives/
git mv mydocs/pr/pr_{N}_review_impl.md mydocs/pr/archives/  # if it exists
git mv mydocs/pr/pr_{N}_report.md mydocs/pr/archives/

Commit once or by review phase. External PR review does not force the internal stage format.
```
git commit -m "PR #{N} review: {summary}"
```

Verification

mydocs/pr/pr_{N}_review.md fills required sections from mydocs/_templates/external_pr_review.md.
If written, mydocs/pr/pr_{N}_review_impl.md fills required sections from mydocs/_templates/external_pr_review_impl.md.
mydocs/pr/pr_{N}_report.md fills required sections from mydocs/_templates/external_pr_report.md.
The recommendation is explicit: merge, request changes, or close.
After processing, created PR review documents exist in mydocs/pr/archives/.

Never Do

Apply this SKILL to internal task PRs such as publish/task{N}.
Merge or close an external PR without task requester approval.
Cherry-pick code from an external contributor fork directly into this repository while bypassing PR procedure.
Force internal stage documents such as _stage{N}.md and _report.md onto external PR review documents.

Invocation

Codex: $external-pr-review or the /skills menu
Claude Code: /external-pr-review