---
title: "Astral ty: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/astral-ty/
description: "Astral's skill for type-checking Python with ty: invocation through uv, ty check options, [tool.ty] configuration with per-file overrides, mypy and Pyright command mappings, and rule-specific ignores."
---

# Astral ty: review, setup & limitations · Undominated.ai

> Astral's skill for type-checking Python with ty: invocation through uv, ty check options, [tool.ty] configuration with per-file overrides, mypy and Pyright command mappings, and rule-specific ignores.

[← Explore all skills](/skills/)

LANGUAGES AND TOOLING / Astral

# Astral ty

Astral's skill for type-checking Python with ty: invocation through uv, ty check options, [tool.ty] configuration with per-file overrides, mypy and Pyright command mappings, and rule-specific ignores.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/astral-sh/claude-code-plugins/tree/f3ce88a7ba830f53afd6d944c1d0278ed318e142/plugins/astral/skills/ty)

SOURCE REVIEW

 Reviewed 2026-10-21
 Evidence 5 linked sources
 Publisher Astral
 Licence [MIT OR Apache-2.0 ↗](https://raw.githubusercontent.com/astral-sh/claude-code-plugins/f3ce88a7ba830f53afd6d944c1d0278ed318e142/LICENSE-MIT)
 Revision f3ce88a7ba83
 [Read what was—and wasn’t—checked ↓](#review)

“Guide for using ty, the extremely fast Python type checker and language server. Use this when type checking Python code or setting up type checking in Python projects.”

 [Astral · upstream description ↗](https://raw.githubusercontent.com/astral-sh/claude-code-plugins/f3ce88a7ba830f53afd6d944c1d0278ed318e142/plugins/astral/skills/ty/SKILL.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - It is Astral's own skill for ty, from astral-sh/claude-code-plugins, covering ty check on a directory or file, rule severity flags (--error, --warn, --ignore), Python version and platform targeting, and [tool.ty] configuration with [[tool.ty.overrides]] for tests.
- It tells the agent to fix type errors rather than suppress them, and when an ignore is requested to use a rule-specific ty: ignore[...] rather than a blanket ty: ignore or type: ignore.

### A good fit for

 - Type-check a Python project, a directory or one file with ty check
- Translate mypy or Pyright invocations into ty check commands
- Relax chosen ty rules for test files with [[tool.ty.overrides]]

### Weigh up before choosing

 - Last commit touching plugins/astral/skills/ty at revision f3ce88a7: 2026-02-27 (f3ce88a).
- Installing the astral plugin configures a ty language server for .py and .pyi files that runs uvx ty@latest server, so the ty version is whatever latest resolves to when the server starts.
- The README says the plugin's language server requires uvx to be available.
- The one install line brings the whole astral plugin, with the uv and ruff skills as well as this one.
- The README licenses the repository under Apache-2.0 or MIT at the user's option; plugins/astral/.claude-plugin/plugin.json lists MIT only.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - plugins/astral/skills/ty/SKILL.md
- plugins/astral/.claude-plugin/plugin.json
- README.md
- LICENSE-MIT
- LICENSE-APACHE

### Our findings

 - The ty SKILL.md frontmatter has a name and a description only; it declares no allowed-tools, and the skill directory contains just SKILL.md.
- It names two invocations: uv run ty inside a project (pinned version, or a global ty with the virtual environment updated) and uvx ty for one-off checks.
- Its migration table maps mypy --strict to ty check --error-on-warning and plain mypy or pyright runs to ty check.
- The plugin manifest's lspServers entry maps .py and .pyi to the ty server.

### Not established by this review

 - No ty command was run and the language server was not started.
- The mypy and Pyright mappings are the skill's own; this review did not compare their results with ty's.
- Not executed: it was not installed or run.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Add a skill to your workflow.

[Upstream setup instructions ↗](https://raw.githubusercontent.com/astral-sh/claude-code-plugins/f3ce88a7ba830f53afd6d944c1d0278ed318e142/README.md)
 - The Astral README prints `/plugin marketplace add astral-sh/claude-code-plugins`, then `/plugin install astral@astral-sh`; that installs the astral plugin as a whole, ty skill and language server included, so it is not ty's own command and install.command is null.
- The README also shows browsing with `/plugin` and a team setup through extraKnownMarketplaces and enabledPlugins in .claude/settings.json.
- Invoke the skill as /astral:ty.
- This review neither installed the plugin nor started its language server.

### Before you start

 - Claude Code
- uvx available, for the ty language server the plugin configures

### Compatibility

Claude Code

### Guidance for running ty, plus a ty language server the plugin starts through uvx

 - The ty skill sets no allowed-tools, so its commands run with the session's permissions
- The plugin's lspServers entry runs uvx ty@latest server for .py and .pyi files, with no pinned ty version
- ty check with no path checks all files in the current directory, per the skill

### Cost model

MIT or Apache-2.0 at the user's option; ty is not part of this repository and is run through uv or uvx

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Astral ty SKILL.md ↗](https://raw.githubusercontent.com/astral-sh/claude-code-plugins/f3ce88a7ba830f53afd6d944c1d0278ed318e142/plugins/astral/skills/ty/SKILL.md) Checked 2026-10-21 https://raw.githubusercontent.com/astral-sh/claude-code-plugins/f3ce88a7ba830f53afd6d944c1d0278ed318e142/plugins/astral/skills/ty/SKILL.md Supports: upstreamDescription, summary, whySelected[0], whySelected[1], bestFor[0], bestFor[1], bestFor[2], review.findings[0], review.findings[1], review.findings[2], access.permissions[0], access.permissions[2], access.cost
- [Astral plugins README ↗](https://raw.githubusercontent.com/astral-sh/claude-code-plugins/f3ce88a7ba830f53afd6d944c1d0278ed318e142/README.md) Checked 2026-10-21 https://raw.githubusercontent.com/astral-sh/claude-code-plugins/f3ce88a7ba830f53afd6d944c1d0278ed318e142/README.md Supports: install.sourceUrl, install.steps[0], install.steps[1], install.steps[2], install.prerequisites[0], install.prerequisites[1], limitations[2], limitations[3], limitations[4], license, compatibility, whySelected[0]
- [astral plugin.json ↗](https://raw.githubusercontent.com/astral-sh/claude-code-plugins/f3ce88a7ba830f53afd6d944c1d0278ed318e142/plugins/astral/.claude-plugin/plugin.json) Checked 2026-10-21 https://raw.githubusercontent.com/astral-sh/claude-code-plugins/f3ce88a7ba830f53afd6d944c1d0278ed318e142/plugins/astral/.claude-plugin/plugin.json Supports: limitations[1], limitations[4], review.findings[3], access.permissions[1], access.label
- [LICENSE-MIT ↗](https://raw.githubusercontent.com/astral-sh/claude-code-plugins/f3ce88a7ba830f53afd6d944c1d0278ed318e142/LICENSE-MIT) Checked 2026-10-21 https://raw.githubusercontent.com/astral-sh/claude-code-plugins/f3ce88a7ba830f53afd6d944c1d0278ed318e142/LICENSE-MIT Supports: license, access.cost
- [LICENSE-APACHE ↗](https://raw.githubusercontent.com/astral-sh/claude-code-plugins/f3ce88a7ba830f53afd6d944c1d0278ed318e142/LICENSE-APACHE) Checked 2026-10-21 https://raw.githubusercontent.com/astral-sh/claude-code-plugins/f3ce88a7ba830f53afd6d944c1d0278ed318e142/LICENSE-APACHE Supports: license, access.cost

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Astral ruff ↗ Astral's skill for linting, fixing and formatting Python with ruff: when to use it, how to invoke it, which changes to avoid, and how Black, Flake8 and isort commands map onto ruff.](/skills/astral-ruff/)[### Ruff Recursive Fix ↗ Enforces Python code quality with scoped Ruff runs: safe fixes first, unsafe fixes second with diff review each pass, then targeted manual remediation under explicit stop criteria.](/skills/github-ruff-recursive-fix/)[### .NET Timezone ↗ Resolves .NET timezone work through the right library first — TimeZoneConverter for cross-platform, NodaTime for recurring schedules and strict DST arithmetic — and ships both Windows and IANA identifiers on every answer, seven copy-paste code patterns, and the pitfall list from DateTimeKind.Unspecified to DST transitions that skip or repeat local times.](/skills/github-dotnet-timezone/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
