pre-commit-quality-gate

Run pre-commit quality checks and report readiness as ready or caveat.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/Vel-Labs/ClearIntent --skill pre-commit-quality-gate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pre-commit-quality-gate
Source: https://github.com/Vel-Labs/ClearIntent/tree/main/skills/pre-commit-quality-gate
Command: npx skills add https://github.com/Vel-Labs/ClearIntent --skill pre-commit-quality-gate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents regressions by enforcing pre-commit quality checks before code enters version control, reducing defects and manual review overhead.

Core Features & Use Cases

  • Deterministic local checks that validate repository state before commits, pushes, or merges.
  • Integration with typical npm-based workflows to run validate:scaffold, validate:contracts, test:contracts, test, typecheck, and check.
  • Policy-driven gating that aligns with project governance, including documentation routing and scaffold validation.

Quick Start

Run the pre-commit quality gate to validate changes before committing.

Frequently Asked Questions about pre-commit-quality-gate

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

FAQPage Schema
How do I run pre-commit quality checks to prevent regressions before pushing code?

Pre-commit quality checks prevent regressions by automating validation for commits, pushes, and merges. This gate reads REPO_PROFILE.json and AGENTS.md to run scaffold, contracts, tests, and type checks, reporting readiness as ready or caveat.

What is a pre-commit quality gate and how does it validate repository state?

A pre-commit quality gate is a deterministic workflow that validates repository state before code enters version control. It reads repository profiles and agent docs to enforce scaffold, contract, test, and type check validations, reporting readiness status.

Does the pre-commit gate work with npm-based workflows for contract and scaffold validation?

Yes, the pre-commit gate integrates with typical npm-based workflows to run validate:scaffold, validate:contracts, test:contracts, test, typecheck, and check commands. This ensures policy-driven gating aligns with project governance during local development handoffs.

Can I use pre-commit validation for merge-readiness checks across contracts and docs?

Yes, pre-commit validation applies to local workflows around commits, pushes, handoffs, and merges across contracts, docs, scaffolds, and CI pipelines. It validates repository state and reports readiness to prevent regression before code enters version control.

Why do I need a deterministic pre-commit workflow for local development handoffs?

A deterministic pre-commit workflow is needed to reduce defects and manual review overhead during local development handoffs. It enforces quality checks by validating scaffolds and contracts, running tests and type checks before code enters version control.

What are the limitations of pre-commit gating when validating repository state?

Pre-commit gating limitations involve its dependency on reading REPO_PROFILE.json and AGENTS.md for deterministic validation. It focuses on local pre-commit, pre-push, and merge-readiness checks, reporting only ready or caveat statuses without auto-fixing issues.