Menu
Checklist of files to update when adding or updating a rubocop plugin gem
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
Review PRs created by the agent cop fix workflow and approve, fix, or close them.
Fix variant (EnforcedStyle) FP/FN on a cop — either a CI regression on a bot PR, or outstanding divergence from the corpus oracle. Auto-reads docs/corpus.md for examples.
Get a department or gem all the way to 100% conformance using per-cop validation and generated corpus reports, never manual README/docs edits.
Drive a department or gem all the way to 100% conformance using per-cop validation and generated corpus reports, never manual README/docs edits.
Rank cops by FP+FN from the corpus oracle to find the next batch to fix
| name | update-gem |
| description | Checklist of files to update when adding or updating a rubocop plugin gem |
| allowed-tools | Read, Grep, Glob |
When adding a new rubocop plugin gem or updating an existing gem version, the following files must be updated. Use this checklist to ensure nothing is missed.
bench/corpus/GemfilePin the gem version (e.g. gem "rubocop-rake", "0.7.1").
bench/corpus/diff_results.pyAdd or update the gem version in the "baseline" dictionary inside write_corpus_results().
bench/corpus/baseline_rubocop.ymlAdd the gem to the plugins: list. If any cops are Enabled: false in the gem's vendor default config, add explicit Enabled: true overrides (see existing examples for RSpec, Rails, etc.). Cops that default to Enabled: true or Enabled: pending don't need overrides — NewCops: enable handles pending cops.
bench/corpus/update_readme.pyAdd an entry to the GEMS list with key, url, and departments.
scripts/dispatch_cops.pyAdd the department to DEPT_TO_VENDOR (maps department name to vendor/<gem-dir>). If the department name doesn't snake_case cleanly (e.g. FactoryBot -> factory_bot, RSpecRails -> rspec_rails), also add it to DEPT_TO_DIR and DEPT_TO_SRC_DIR.
.github/workflows/batch-dispatch.ymlAdd the department to the department choice options list (keep alphabetical order).
Add the vendor submodule pinned to the release tag: git submodule add <repo-url> vendor/<gem-name>.
New cops default to preview tier via src/resources/tiers.json. Promotion to stable happens automatically via the corpus oracle workflow — do not manually edit tiers.json. The corpus oracle uses --preview so preview-tier cops are always tested in CI, but users running nitrocop locally without --preview won't see them.
See PR #1353 (rubocop-rake support) for an example of adding a new plugin gem, though note it missed several of the items in this checklist (fixed in a follow-up commit).
After making changes, run:
uv run ruff check bench/corpus/diff_results.py scripts/dispatch_cops.py bench/corpus/update_readme.py