prepare

Runs checks, detects public API changes, and flags stale docs before merging.

Updated Nov 7, 2025
One-click install
npx skills add https://github.com/rangojs/rango --skill prepare-rangojs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prepare
Source: https://github.com/rangojs/rango/tree/main/.claude/skills/prepare
Command: npx skills add https://github.com/rangojs/rango --skill prepare-rangojs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before merging changes to the Rango router codebase, developers must manually run format, typecheck, lint, and unit tests, then remember to check whether public API exports changed and whether skills or internal docs need updating. This Skill automates that pre-merge readiness review in one guided workflow. ## Core Features & Use Cases - Parallel quality checks: Runs format, typecheck, lint, and unit tests concurrently and reports failures before continuing. - Public API change detection: Diffs the working tree against known export surface files and flags added, removed, or renamed exports, then reports which skills and docs may need updates without auto-editing them. - Semantic matrix gating: Detects changes to semantic-critical router files and runs Playwright semantic-matrix tests in dev and production. - Use Case: After refactoring a router export, run this Skill to confirm all checks pass, get a list of affected docs and skills, and receive a suggestion to run /simplify on non-trivial new code. ## Quick Start Ask the assistant to run the prepare skill to validate the current changes before merging.

Frequently Asked Questions about prepare

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

FAQPage Schema
How do I run all checks before merging a pull request?

Run the prepare skill, which executes pnpm format, typecheck, lint, and unit tests concurrently from the repo root. It reports any failures and requires them to be fixed before continuing to later steps.

How to detect public API changes in a TypeScript package?

The skill runs git diff against a defined list of export surface files such as index.ts, server.ts, and package.json exports. It flags added, removed, or renamed exports and signature changes, then reports which skills and docs may need updates.

Does the prepare skill automatically update docs and skills?

No, it only reports findings. When public API changes or stale internal reference docs are detected, it lists the affected files and what might need updating, leaving all edits to the developer.

When does the semantic matrix test gate run?

It runs only when the diff touches semantic-critical files such as segment-resolution, middleware, intercept, or revalidation modules. The skill then executes Playwright semantic-matrix tests in both dev and production modes, and all rows must pass.

Why does the skill suggest running /simplify?

When the diff contains non-trivial new or modified implementation code, the skill suggests running /simplify to review the changes for reuse, quality, and efficiency. It skips this suggestion for formatting-only, config, test-only, or doc-only changes.