check-pr-readiness

Run diff-scoped typechecking, linting, formatting, and tests on pull requests.

121|2|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/AgentSystemLabs/core --skill check-pr-readiness
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: check-pr-readiness
Source: https://github.com/AgentSystemLabs/core/tree/main/plugins/agentsystem-core/skills/check-pr-readiness
Command: npx skills add https://github.com/AgentSystemLabs/core --skill check-pr-readiness

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents broken or low-quality code from landing in a pull request by running a consistent pre-flight check across the branch’s actual diff, then stopping immediately on the first failing gate.

Core Features & Use Cases

  • Diff-scoped gauntlet: Computes the base range and checks only what changed (plus relevant residue signals from added lines).
  • Tooling-aware detection: Identifies the project’s real commands for typechecking, linting, formatting, and testing instead of guessing.
  • Strict failure semantics: Stops at the first red gate, reports the exact reproduction command, and never silently fixes code (except offering format auto-fix when supported).
  • Residue sweep: Flags likely “forgotten” issues in the diff such as console.log, debugger statements, .only/.skip, newly added TODOs/FIXMEs, and large/binary additions.
  • Use case: Before pushing a PR, ensure production readiness and catch common review blockers like type errors, formatting drift, flaky residue, or unintended file changes.

Quick Start

Run pre-pr check so the skill evaluates your branch against the base and reports whether it’s PR-ready or blocked.

Frequently Asked Questions about check-pr-readiness

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

FAQPage Schema
How do I check pull request readiness before merging a branch?

To check pull request readiness, run a pre-pr check that evaluates your branch diff against the base. It runs diff-scoped typechecking, linting, formatting, and tests, stopping at the first failure and reporting whether your branch is ready or blocked.

What is diff-scoped linting and typechecking for a pull request?

Diff-scoped linting and typechecking evaluates only the code changes within a branch's computed base range. This prevents unintended file changes from failing the pull request check and focuses production-readiness guarantees on the actual modifications made.

How do I catch console.log and debugger statements left in my code before pushing?

To catch console.log and debugger statements, run a residue sweep on your diff. This pull request check flags likely left-behind code such as console.log, debugger statements, .only/.skip, newly added TODOs/FIXMEs, and large or binary additions.

Can I auto-fix formatting issues during a pull request readiness check?

You can auto-fix formatting issues during the pull request check only when a write-capable script exists. The check identifies your project's real formatting command and offers format auto-fix if supported, but never silently fixes code otherwise.

Does the pull request check work with my project's existing typecheck and test commands?

The pull request check works with your project's existing tooling by detecting the real commands defined for typechecking, linting, formatting, and testing instead of guessing. It executes these gates in a fixed order and reports pass or fail with exact reproduction commands.

Why does my pull request readiness check stop at the first failing gate?

A pull request readiness check stops at the first failing gate to prevent broken or low-quality code from landing. This strict failure semantics ensures you get the exact reproduction command for the specific failure, allowing you to fix the issue before checking subsequent gates.