readability-review

Review GitHub pull requests for readability and style-guide compliance.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/RealXP-Lab/armory --skill readability-review-realxp-lab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: readability-review
Source: https://github.com/RealXP-Lab/armory/tree/main/claude-plugins/readability-review/skills/readability-review
Command: npx skills add https://github.com/RealXP-Lab/armory --skill readability-review-realxp-lab

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill automates readable, style-guide–compliant reviews of GitHub pull requests so maintainers can catch clear style violations and reduce noisy or ambiguous feedback.

Core Features & Use Cases

  • Bundled style guides: Loads per-language guides from the references directory and only applies them to matching file types in the PR.
  • Parallel reviewers & confidence scoring: Launches parallel review agents that flag issues and score each finding from 0–100, filtering out low-confidence or pre-existing problems.
  • GitHub integration and safety checks: Uses gh to fetch PR diffs, skip third-party/vendor files, re-check eligibility, and post a concise, cite-backed comment summarizing validated issues.
  • Use Case: Run this on a Unity repository to review C# and shader changes against project style guides and CLAUDE.md guidance, getting only high-confidence violations.

Quick Start

Review pull request 42 for readability and style guide compliance.

Frequently Asked Questions about readability-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate code readability and style guide checks for Unity C# and shader pull requests?

You can automate code readability and style guide checks by running parallel review agents that fetch GitHub PR diffs, classify Unity C# and shader files, and post high-confidence violations as a concise comment.

Does this automated PR review tool skip vendor and third-party code?

Yes, automated PR review skips vendor and third-party code by classifying files by extension and filtering them out before applying bundled style guides and CLAUDE.md guidance to the remaining changes.

How do GitHub pull request reviews handle low-confidence style violations?

GitHub pull request reviews handle low-confidence style violations by scoring each finding from 0–100 and filtering out low-confidence or pre-existing problems before posting only validated, cite-backed issues.

Can I review shader file changes against a project style guide in a GitHub PR?

Yes, you can review shader file changes by applying bundled per-language style guides from the references directory to matching file types in the PR diff, ensuring only relevant style rules are enforced.

What do I need to fetch PR diffs and post review comments on GitHub?

You need gh access to fetch PR diffs and post review comments, along with bundled reference style guides and CLAUDE.md guidance to direct the parallel review agents and confidence scoring.

When should I use automated readability scoring instead of manual code review?

You should use automated readability scoring when you want to catch clear style violations and reduce noisy or ambiguous feedback on Unity repository PRs before maintainers perform manual code review.