reviewing-readability

reviewing-readability is a Refactoring & code quality skill for AI agents, published by streamlit in the streamlit repository on GitHub. Skillspace rates reviewing-readability D (68/100) and it passed the safety scan; a judge model has also reviewed it.

Evaluates comments, docstrings, and naming in code for readability by a developer new to the codebase — is the documentation clear and concise, and is non-obvious logic documented? Produces findings with concrete proposed rewrites (or additions where documentation is missing); the caller decides whether to apply them or present them as feedback. Use when reviewing a PR, branch, or set of changes for comment quality, naming clarity, or documentation readability. For a PR's title and description, use reviewing-pr-description instead.

Grade
D
Quality
68 / 100
Safety
Passed
GitHub stars
45,243

Placed #3 of 6 in the judged category final for Refactoring & code quality.

Our two independent classifiers differ on this skill's category, so treat the placement as provisional.

This rating describes the version of the repository we crawled; it may have changed since, so go by its current files.

Our review

Architecture
100 / 100
Maturity
Basic: a single SKILL.md
Security scan
No issues found
License
Apache-2.0
Adoption
Adopted by 0 other repositories, in 0 collections
Scope
Portable: works in any project. Generic readability review of comments, docstrings, and naming

Judge review

Placed #3 of 6 in the judged category final for Refactoring & code quality.

  • Trigger8585
  • Instructions9292
  • Specificity8585
  • Safety9090
  • Disclosure6868
  • Maintenance7272
Nine well-justified principles and a strict evaluate-only stance (findings, not edits) make this unusually rigorous for a review skill.

Not checked yet

  • No blind task eval yet
  • Sibling files (scripts, references) not fetched; security scan covers SKILL.md only

Skillspace indexes and rates this skill; it does not host or endorse it. Run third-party skills at your own risk.