How do I install the Python Ty skill?

Run npx skillmds@latest add majiayu000/python-ty in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Python Ty safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Python Ty?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Python Ty free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Python Ty?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Python Ty by majiayu000 — Agent Skill

Name: Python Ty
Rating: 4.2 (5 reviews)
Author: majiayu000

Python Ty

Fast Python type checking with ty (by Astral). Use when checking Python types, running type checks in CI, or setting up type checking for Python projects. Triggers on "type check", "ty check", "python types", or type error debugging.

majiayu000 Updated Sep 9, 2026 567 repo stars

File contents

Python Type Checking with `ty`

ty is an extremely fast Python type checker from Astral (makers of Ruff).

Quick Start

# Run type checker (no install needed)
uvx ty check

# Check specific files
uvx ty check src/ tests/

Installation (Optional)

# Install globally
uv tool install ty@latest

# Update
uv tool upgrade ty

Common Tasks

# Watch mode - auto-recheck on file changes
ty check --watch

# Target specific Python version
ty check --python-version 3.11

# Concise output
ty check --format concise

# Exclude test files
ty check --exclude "**/test_*.py"

Configuration File

Create ty.toml in project root (auto-discovered):

python-version = "3.11"
exclude = ["**/test_*.py", "**/__pycache__/**"]
format = "concise"

CI/CD

# Strict CI check
ty check --error all --error-on-warning --no-progress

Exit codes: 0 = success, 1 = errors found, 2 = internal error

Advanced Options

Severity Control

ty check --error all        # All issues as errors
ty check --warn typing      # Typing issues as warnings
ty check --ignore unused    # Ignore unused imports

Environment Targeting

ty check --python /path/to/python    # Specific interpreter
ty check --venv /path/to/venv        # Target virtualenv
ty check --python-platform linux     # Cross-platform check
ty check --extra-search-path ./stubs/

Output Formats

ty check --format full       # Detailed (default)
ty check --format concise    # Compact
ty check --format github     # GitHub Actions annotations
ty check --format gitlab     # GitLab CI format
ty check --color never       # No colors
ty check --no-progress       # Hide progress bar
ty check -v                  # Verbose
ty check -q                  # Quiet

Other Commands

ty server                              # Start LSP server
ty version                             # Show version
ty generate-shell-completion zsh       # Shell completions

---name: python-tydescription: Fast Python type checking with ty (by Astral). Use when checking Python types, running type checks in CI, or setting up type checking for Python projects. Triggers on "type check", "ty check", "python types", or type error debugging.--- # Python Type Checking with `ty` `ty` is an extremely fast Python type checker from Astral (makers of Ruff). ## Quick Start ```bash # Run type checker (no install needed) uvx ty check # Check specific files uvx ty check src/ tests/ ``` ## Installation (Optional) ```bash # Install globally uv tool install ty@latest # Update uv tool upgrade ty ``` ## Common Tasks ```bash # Watch mode - auto-recheck on file changes ty check --watch # Target specific Python version ty check --python-version 3.11 # Concise output ty check --format concise # Exclude test files ty check --exclude "**/test_*.py" ``` ## Configuration File Create `ty.toml` in project root (auto-discovered): ```toml python-version = "3.11" exclude = ["**/test_*.py", "**/__pycache__/**"] format = "concise" ``` ## CI/CD ```bash # Strict CI check ty check --error all --error-on-warning --no-progress ``` Exit codes: `0` = success, `1` = errors found, `2` = internal error --- ## Advanced Options ### Severity Control ```bash ty check --error all # All issues as errors ty check --warn typing # Typing issues as warnings ty check --ignore unused # Ignore unused imports ``` ### Environment Targeting ```bash ty check --python /path/to/python # Specific interpreter ty check --venv /path/to/venv # Target virtualenv ty check --python-platform linux # Cross-platform check ty check --extra-search-path ./stubs/ ``` ### Output Formats ```bash ty check --format full # Detailed (default) ty check --format concise # Compact ty check --format github # GitHub Actions annotations ty check --format gitlab # GitLab CI format ty check --color never # No colors ty check --no-progress # Hide progress bar ty check -v # Verbose ty check -q # Quiet ``` ### Other Commands ```bash ty server # Start LSP server ty version # Show version ty generate-shell-completion zsh # Shell completions ```

Frequently asked questions