Readability Review

Review naming, decomposition, control flow, duplication, comments, error-handling clarity, and unnecessary abstraction.

jsuvic c88ac00 943 B Updated

File contents

Readability Review

Focus

  • Names that communicate intent and domain meaning.
  • Decomposition, control flow, and error-handling clarity.
  • Duplication and comments that obscure rather than explain.
  • Unnecessary abstraction or indirection.

Output Discipline

  • Lead with prioritized findings and concrete evidence.
  • Cite the affected file, symbol, or contract when available.
  • Distinguish confirmed defects from risks or missing evidence.
  • Do not edit or rewrite the change unless the user asks.

Safety

  • Review only; do not run scanners, install tools, or broaden permissions.
  • Do not upload source code or read or print secrets.
  • Do not contact production systems or external services.

jsuvic/agent-profile/tree/main/fixtures/advanced-review-enabled/expected/.agents/skills/readability-review commit c88ac00b43

Frequently asked questions

npx skillmds@latest add jsuvic/readability-review