verification

Run pytest, mypy, ruff, and pre-commit checks before declaring completion.

6|Updated Dec 29, 2025
One-click install
npx skills add https://github.com/HomericIntelligence/ProjectHephaestus --skill verification-homericintelligence
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: verification
Source: https://github.com/HomericIntelligence/ProjectHephaestus/tree/main/skills/verification
Command: npx skills add https://github.com/HomericIntelligence/ProjectHephaestus --skill verification-homericintelligence

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Claiming work complete without verification is risky; this skill enforces evidence-before-claim practices to reduce misrepresentations and gate PR readiness.

Core Features & Use Cases

  • Automated verification gate: runs a predefined suite of checks before declaring success.
  • Supports unit tests, type checks, linting, formatting checks, and pre-commit validation.
  • Use Case: before merging a feature branch, run the full verification cycle to ensure all checks pass and outputs are documented.

Quick Start

Run all verification commands exactly as specified and report the full outputs with exit codes as evidence.

Frequently Asked Questions about verification

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

FAQPage Schema
How do I run automated verification checks before claiming a pull request is ready?

Automated verification before a pull request requires executing pytest, mypy, ruff lint, ruff format check, and pre-commit hooks, then validating their outputs and exit codes as evidence of readiness.

What is a verification gate in software development and how does it work?

A verification gate is a process that runs a predefined suite of checks including unit tests, type checks, linting, formatting, and pre-commit validation before any completion claim to ensure software quality.

How do I enforce evidence-before-claim practices for unit tests and type checks?

You enforce evidence-before-claim practices by running pytest on unit tests and mypy type checks, requiring their full outputs and exit codes to be documented and validated before asserting success.

Does the verification process support ruff format checks and pre-commit hooks?

Yes, the verification process supports running ruff format checks and pre-commit hooks alongside pytest and mypy, validating all five command outputs and exit codes before declaring work complete.

What's the best way to validate work with evidence before declaring a feature branch complete?

The best way to validate work before declaring a feature branch complete is to run the full verification cycle of pytest, mypy, ruff lint, ruff format, and pre-commit hooks, ensuring all checks pass with documented outputs.

Why does claiming work complete without verification pose risks to software quality?

Claiming work complete without verification poses risks because it allows misrepresentations and unverified code to enter the codebase, bypassing unit tests, type checks, and linting that gate PR readiness.