Menu
Run and interpret the awesome-list compliance linter for README.md. Use before opening or reviewing any pull request that touches the README.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
End-to-end procedure for adding one resource to the list — duplicate search, source verification, canonical formatting, section placement, and validation. Use whenever a new entry is being added to README.md.
Measure how comprehensive and current the list is — entries per section and per year, with thin and stale sections flagged. Use before planning content expansion or periodically as a health check.
Validate that every link in the curated list resolves and points at the intended resource. Use before opening or reviewing a pull request that adds or edits entries.
| name | awesome-lint |
| description | Run and interpret the awesome-list compliance linter for README.md. Use before opening or reviewing any pull request that touches the README. |
Validates that README.md complies with the
awesome list guidelines enforced by
awesome-lint. CI runs this on every
push and pull request.
npm run lint:awesome # runs: awesome-lint README.md
The script passes README.md explicitly — do not run bare npx awesome-lint on
Windows, where absolute C:\ paths are misparsed as URLs and the run fails with
Invalid GitHub repo URL.
Common failures and their fixes:
awesome-badge — the [](https://awesome.re)
badge must sit inside the main # heading line.awesome-toc — the ## Contents section must be the first section; each ToC item
must match its heading in order. Contributing and License must not appear in
the ToC.awesome-license — a ## License section in the README is forbidden; the
license lives in the LICENSE file (CC0) with at most a prose mention elsewhere.double-link — the same URL may appear only once in the document (this includes
badge links and #anchor links).table-pipe-alignment — table pipes must be column-aligned. Format the table
block through Prettier and paste it back (the README itself is Prettier-excluded).balanced-punctuation — usually mojibake (e.g. — for an em dash) rather than a
real unmatched quote; fix the encoding artefact.- [Title](URL) - Description. (Year) passes the linter —
do not "fix" entry punctuation.README.md is excluded from Prettier and from wholesale reformatting; apply only the
minimal edit each finding needs.A clean awesome-lint run is necessary but not sufficient — entries must still satisfy
CONTRIBUTING.md; pair this with the
link-check skill.