Verify Project Health

Run uv commands for linting, formatting, and tests to validate project health.

Updated Jan 21, 2026
One-click install
npx skills add https://github.com/Row0902/agents --skill verify-project-health
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Verify Project Health
Source: https://github.com/Row0902/agents/tree/main/.agent/skills/verify_project_health
Command: npx skills add https://github.com/Row0902/agents --skill verify-project-health

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Before any task_boundary completion or notify_user call, code must be verified.

Core Features & Use Cases

  • Type Check: Mentally verify: "Are all arguments typed?" "Is Any avoided?" (Future) uv run mypy src
  • Linting (Strict): Command: uv run ruff check src
  • Formatting: Command: uv run ruff format src
  • Testing: Command: uv run pytest
  • Action: If tests fail, FIX them. Do not comment them out.

Quick Start

Run the project health workflow to verify linting, type safety, formatting, and tests.

Frequently Asked Questions about Verify Project Health

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

FAQPage Schema
How do I run Python linting and type checks before completing a task?

To verify Python code health, run `uv run ruff check src` for linting and `uv run pytest` for tests. This automated validation ensures type safety, formatting, and testing pass before any task completion or user notification.

What is the best way to automate pytest and ruff checks during development?

Automating pytest and ruff checks is best handled by running `uv run ruff check src` and `uv run pytest` together. This project health workflow ensures continuous linting, formatting, and testing validation throughout the development cycle.

How do I fix failing tests during code quality validation?

To fix failing tests during code quality validation, you must actively resolve the test failures rather than commenting them out. Run `uv run pytest` to identify failures and correct the underlying code to maintain strict project health.

Does this project health validation workflow support strict ruff formatting?

Yes, project health validation supports strict ruff formatting by executing `uv run ruff format src`. This ensures code formatting compliance alongside linting and testing checks using the ruff tool within the Python environment.

When do I need to run code health checks for Python projects?

You need to run code health checks for Python projects before any task_boundary completion or notify_user call. This ensures linting, type safety, formatting, and tests pass via uv commands before proceeding with development milestones.