/pyright-heal

Repair Pyright type errors in Python files and notebooks through iterative fixes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automatically heals Python code by repairing Pyright type errors and guiding deterministic fixes, reducing manual debugging time.

Core Features & Use Cases

  • Iterative healing loop: run Pyright, parse errors, apply targeted fixes, and re-run until clean.
  • Error coverage: fixes for attribute/method not found, import issues, type mismatches, undefined vars, and argument mismatches.
  • Use Case: When migrating legacy Python projects with pervasive type issues, this skill speeds up achieving type-safe codebases and faster iteration.

Quick Start

Use the pyright-heal skill to fix a Python file:

  • /pyright-heal path/to/file.py
  • /pyright-heal path/to/file.py --max-iterations 5
  • /pyright-heal path/to/file.py --strict

Frequently Asked Questions about /pyright-heal

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

FAQPage Schema
How do I automatically fix Pyright type errors in Python?

You can automatically fix Pyright type errors by running an iterative healing loop that parses errors, applies targeted code changes, and rechecks the file until it is clean.

Can I automatically repair type mismatches and undefined variables in a Python notebook?

Yes, automated repair applies to both Python files and Jupyter notebooks by reading type errors, applying fixes for issues like undefined variables, and rechecking the code iteratively.

What types of Python type checking errors can be automatically healed?

Automated healing covers attribute or method not found, import issues, type mismatches, undefined variables, and argument mismatches by applying targeted fixes iteratively.

How do I run Pyright strict mode type fixes on a Python file?

You can run Pyright strict mode fixes by specifying the strict flag in your command, which enforces stricter type checking rules during the iterative error repair loop.

Is there a limit to how many times the Python type error fix loop runs?

The iterative fix loop uses a configurable maximum iterations parameter, allowing you to define exactly how many times Pyright reads errors, applies changes, and rechecks the code.

Why should I use an automated fix loop for legacy Python type migration?

Using an automated fix loop for legacy Python migration speeds up achieving a type-safe codebase by reducing manual debugging time when resolving pervasive type issues across files.