I built a repo where a first PR is one folder, and a 144-line validator reviews the format

Description and use

A 144‑line Python validator automates PR format checks for a Spanish skill catalog, easing maintainer workload and simplifying first PRs for newcomers.

Problem

Maintainers spend time manually checking PR format; newcomers struggle with first PRs.

Outcome

A 144-line Python script validates skill PRs automatically, reducing maintainer effort and helping newcomers submit correct PRs in one round.

Workflow

• Fork repository
• Create new branch
• Add skill folder with SKILL.md and example
• Run local validation or push to trigger CI
• Fix reported errors
• Submit PR
• Review passes automatically

Evidence

Instead of the maintainer checking the format by hand, a Python script (standard library only, 144 lines) runs in CI on every PR.

Source

It returns all errors of a skill at once, not just the first, so a newcomer fixes everything in one round.

Source

Adding a skill never touches code. That matters for people sending their first PR.

Source