ci(ruff): reformat Python snippets in three skill markdown files - #1117
Merged
Conversation
`ruff format --check` fails on `main`, breaking the required `prek`
status on every PR:
3 files would be reformatted, 140 files already formatted
skills/contributor-nomination/fetch.md:202
skills/contributor-sentiment/SKILL.md:217
skills/issue-reproducer/verification.md:60
All three are fenced ```python blocks inside skill docs whose
formatting predates the ruff 0.16.1 bump in 5b504d8. The changes are
what `ruff format` produces and nothing else: comment gap normalised to
two spaces, binary operators spaced, and a blank line after the `import
re` block. No snippet's behaviour or meaning changes.
3 tasks
choo121600
approved these changes
Aug 26, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
ruff format --checkcurrently fails onmain, which breaks the requiredprekstatus on every open PR — including unrelated ones (spotted on chore(asf.yaml): refresh collaborators list and keep approvals through pushes #1116,an
.asf.yaml-only change).```pythonblocks inside skill docs predate the ruff 0.16.1bump in 5b504d8 and no longer match the formatter:
skills/contributor-nomination/fetch.md:202,skills/contributor-sentiment/SKILL.md:217,skills/issue-reproducer/verification.md:60.ruff formatproduces and nothing else: commentgaps normalised to two spaces, binary operators spaced, and a blank line
after an
import re. No snippet changes behaviour or meaning.Type of change
prek, workflows, validators)Test plan
uv run ruff format --check skills/→143 files already formattedprek run --files <the three files>passes every applicable hook(markdownlint, lychee, check-placeholders, skill-and-tool-validate included)
fixture changes apply.
RFC-AI-0004 compliance
Not applicable — whitespace-only changes to documentation snippets.
Linked issues
Refs #1116 (blocked by this failure).
Notes for reviewers
In
issue-reproducer/verification.mdthe reformatted "Bad" Python block nowsits next to an unchanged Java block that still uses wide comment alignment —
ruff doesn't touch Java. The visual asymmetry is cosmetic; aligning the Java
snippet by hand seemed worse than leaving the formatter as the single source
of truth.