pr-review

The pr-review skill acts as a specialized quality gatekeeper for the Schmock ecosystem, designed to enforce strict project standards on every incoming pull request. It is tailored for maintainers and contributors who need to maintain high reliability in API mocking, plugin development, and framework adapters. By automating the evaluation process, it reduces the manual cognitive load required to check behavioral documentation, type safety, and package integrity, ensuring that codebase standards remain consistent across all repositories.

• Validates BDD coverage by ensuring every feature or bugfix has corresponding .feature scenarios and matching .steps.ts definitions.

• Enforces TypeScript strictness by auditing for 'any' type usage, generic misuse, and potential security vulnerabilities like XSS or injection in custom plugins.

• Reviews architectural patterns, checking against over-engineering or premature abstractions, and verifying consistency with Schmock project conventions.

• Inspects commit history for adherence to conventional commit formats (feat, fix, chore) to ensure a clean, maintainable project history.

• Checks package integrity using advanced tooling like publint and attw to ensure proper exports, dependency management, and peer dependency ranges.

• Provides structured, severity-based feedback (Blocker, Suggestion, Nit) to help contributors quickly identify and resolve high-priority issues.

• The skill requires a pull request number as its primary argument to initiate the workflow.

• Uses GitHub CLI (gh) commands internally to fetch diffs and PR metadata, meaning authentication with a GitHub token is required.

• Requires the project to be in a state where bun scripts are available for testing and validation (e.g., bun test:all, bun check:publish).

• Output is structured into clearly defined categories to prevent reviewers from missing critical failures.

• Users should ensure they have the necessary permissions on the repository to run the automated diagnostic steps, as the skill executes tests on the specific branch associated with the PR.