Agent skills that check a research repo for reproducibility, accurate documentation, attribution, and readable code.
For any agent, including Claude Code, Codex, Cursor, Copilot and Gemini CLI:
npx skills@latest add utmist/research-skillsRun this inside your project repo:
/research-repo-review
It runs five audits and gives back one list of findings, blockers first, each pointing at a file and line. Nothing gets edited until you pick what to fix.
The other five also run on their own. Ask to clean up the comments in a file, or whether the project is reproducible, and the matching skill takes over.
You invoke this one by name:
| Skill | Looks for |
|---|---|
| research-repo-review | Runs the five below and merges the results into one report. |
The agent reaches for these on its own:
| Skill | Looks for |
|---|---|
| writing-readmes | README commands that don't resolve, placeholders, numbers with no stated setup, missing sections. |
| reproducible-runs | Unpinned dependencies, undeclared Python version, absolute paths, missing seeds, ML Code Completeness score. |
| citing-sources | LICENSE against the UTMIST default, CITATION.cff, borrowed code with no source or licence. |
| clean-code-naming | Comment noise, commented-out code, docstring bloat, PEP 8 naming, exceptions that silently pass. |
| repo-hygiene | Committed secrets, caches, large files, notebook output, leftover copies, missing .gitignore. |
- No fixed structure. The skills look at properties, not layout. A flat six-file repo is fine, and nothing will tell you to move files to fit a template.
- A README that is true. Claims get checked against the repo at
HEAD. A number nobody can trace is a finding. - Credit for anything borrowed: code, data, weights, papers.
LICENSEdefaults to MIT, copyright UTMIST, matching utmist-ml-seed. - A comment stays only where the code cannot say the thing itself, and then it explains why rather than what.
- Names that mean something, following the conventions of the language. A good name saves you a comment.
Read AGENTS.md for the conventions every skill follows.
MIT, matching utmist-ml-seed. See LICENSE.