v3-pyright-heal

Iteratively run Pyright and apply corrective edits to Python source files.

Updated May 9, 2026
One-click install
npx skills add https://github.com/Ruclo/thesis-artifact --skill v3-pyright-heal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: v3-pyright-heal
Source: https://github.com/Ruclo/thesis-artifact/tree/main/v3/skills/v3-pyright-heal
Command: npx skills add https://github.com/Ruclo/thesis-artifact --skill v3-pyright-heal

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires uv, pyright.

What problem does it solve?

This Skill resolves persistent Python type errors and import issues by iteratively running the Pyright type checker and applying targeted code fixes to ensure codebase integrity.

Core Features & Use Cases

  • Iterative Healing: Automatically runs Pyright, parses error logs, and applies fixes until the code is clean or the iteration limit is reached.
  • Intelligent Patching: Handles common issues like missing attributes, incorrect imports, type mismatches, and undefined variables without manual intervention.
  • Use Case: Use this tool to automatically fix type-checking failures in a large test suite or utility module after a refactor, ensuring all type annotations and imports are correct.

Quick Start

Run the v3-pyright-heal skill on the specified python file to automatically detect and fix all type errors.

Frequently Asked Questions about v3-pyright-heal

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

FAQPage Schema
How do I automatically fix Python type checking errors in my codebase?

You can automatically fix Python type checking errors by iteratively running Pyright and applying corrective edits to source files. This automated healing process resolves missing attributes, incorrect imports, and type mismatches until the codebase achieves strict type compliance.

Can I use this tool to resolve Pyright import issues and undefined variables automatically?

Yes, you can resolve Pyright import issues and undefined variables automatically. The tool parses Pyright error logs and applies intelligent patches to correct incorrect imports, missing attributes, and undefined variables without requiring manual codebase intervention.

Do I need uv and pyright installed to run automated Python type healing?

Yes, you need both uv and pyright installed in your environment to run automated Python type healing. A functional environment with these dependencies is required to perform the static analysis and apply the necessary source file modifications.

What is the best way to ensure strict type compliance across a large Python test suite after a refactor?

The best way to ensure strict type compliance after a refactor is running automated iterative Pyright checks. This tool sequentially analyzes the test suite, resolves type mismatches, and patches imports until all type annotations meet strict compliance standards.

How does iterative type checking handle persistent type mismatches in Python scripts?

Iterative type checking handles persistent type mismatches by repeatedly executing Pyright on Python scripts and applying targeted code fixes. The cycle continues automatically until the error logs are completely clear or the defined iteration limit is reached.

Are there limitations to automated Python type checking and self-healing for configuration files?

The primary limitation of automated Python type checking is the iteration limit; if complex configuration file errors exceed this cap, the cycle stops before achieving clean code. Additionally, it requires a pre-existing functional environment with uv and pyright.