huggingface/self-review
> Use before opening a PR, or whenever asked to self-review a diffusers contribution. Applies the same rubric as the `@claude` CI (checks the diff against .ai/review-rules.md, traces call paths for dead code). Reports findings grouped by severity, flagging what to fix before submitting (blocking issues + dead code) vs what to leave for the actual review. Report-only — does not edit files.
npx skills add https://github.com/huggingface/diffusers --skill self-review
Runs the same rubric as the @claude CI reviewer, so you catch issues before a
maintainer does — but over your whole PR diff. (The CI scopes itself to
src/diffusers/, tests/, and .ai/; for your own PR, also review your docs
and scripts.) You're already on the branch with the conventions loaded, so: get
the
diff → review it against the rubric → report → iterate with the contributor
until it's ready, then remind them to share the final notes on the PR.
git diff main...HEAD # use your target branch if not main
If the branch trails main and the diff looks polluted with unrelated merged
files, scope to your own commits: git log main..HEAD --oneline, then
git show <commit>.
.ai/review-rules.md is the canonical rubric (the CI pins it from main) — read
it and review against it; don't rely on a remembered copy. For the areas you
touched, also read .ai/models.md, .ai/pipelines.md, or .ai/modular.md.
file.py:line →impact. Cite the rule, e.g. *Per .ai/models.md: "…only keep the inference path."*
path:line · Likely-dead / Used · reason.spelling out:
correct; raise these with the reviewer rather than guessing at them now.
Report only — do not edit files. Be concrete, cite the rule, review the whole
diff, and don't invent issues or flag pure style.
Expect several rounds: the contributor addresses findings, you review again.
Keep working with them to fix as much as possible until the verdict is
READY — the Leave for the actual review items are the only ones that
should reach the reviewer unresolved. End the final round's report by
reminding the contributor to share it on the PR (description or a comment) —
it saves the reviewer a few rounds of back-and-forth. Never commit the notes as
part of the diff.
Take huggingface/self-review from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.