repo-readiness

Orchestrates local, GitHub, inspection, and browser evidence into a repository readiness verdict.

5|1|Updated May 5, 2026
One-click install
npx skills add https://github.com/cbusillo/codex-skills --skill repo-readiness-cbusillo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-readiness
Source: https://github.com/cbusillo/codex-skills/tree/main/skills/repo-readiness
Command: npx skills add https://github.com/cbusillo/codex-skills --skill repo-readiness-cbusillo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Determining whether a change, branch, or PR is truly ready to review, merge, ship, or hand off requires gathering scattered evidence from local gates, CI, IDE inspections, and browser checks. This Skill consolidates that evidence into a single truthful readiness verdict with explicit blockers and next actions. ## Core Features & Use Cases - Gate Orchestration: Reads .github/github.json quality gates and repo instructions to decide which tests, lint, typechecks, builds, and inspections must run for the changed surface. - Evidence Aggregation: Delegates to focused skills for JetBrains inspections, GitHub PR/CI state, browser UI validation, and security review, then merges results into one report. - Structured Readiness Report: Returns status (ready, not ready, partially ready, blocked) with passed, failed, pending, and not-run evidence plus the smallest next action. - Use Case: Before merging a feature branch, ask whether the PR is ready; the Skill checks local git state, runs required gates, verifies CI and review status, and reports any blockers with concrete reasons. ## Quick Start Use the repo-readiness skill to check whether my current branch is ready to merge and report the gate evidence.

Frequently Asked Questions about repo-readiness

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

FAQPage Schema
How do I check if my PR is ready to merge?

Run the repo-readiness skill against your branch or PR. It inspects local git state, runs required quality gates, checks GitHub CI and review status, and returns a verdict of ready, not ready, partially ready, or blocked with concrete evidence.

How to run quality gates before shipping code changes?

The skill reads the qualityGate block in .github/github.json to determine which tests, lint, typechecks, builds, and inspections apply. It falls back to AGENTS.md, README, and CI files when metadata is missing, then runs the narrowest checks covering the change.

Does repo-readiness work with JetBrains IDE inspections?

Yes, it delegates inspection execution and triage to the jetbrains-inspection skill. When qualityGate.inspection is configured, readiness requires JetBrains evidence or an explicit not-run reason such as unavailable IDE or blocked indexing.

When should I use repo-readiness versus work-closeout?

Use repo-readiness for the point-in-time readiness verdict and gate evidence. When the task involves wrap-up, safe-to-exit, or handoff, readiness runs first and work-closeout owns the final answer including cleanup and durable parking state.

What happens if a readiness gate cannot run?

The skill reports the gate as not run with a concrete reason, such as unavailable tooling, blocked indexing, or disproportionate cost for a docs-only change. Missing evidence for a required gate means the change is not declared fully ready.