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.
“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.”
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.
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.
- 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
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 ↗Checked
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 ↗Checked
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 ↗Checked
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 ↗Checked
https://raw.githubusercontent.com/astral-sh/claude-code-plugins/f3ce88a7ba830f53afd6d944c1d0278ed318e142/LICENSE-MIT
Supports: license, access.cost
- LICENSE-APACHE ↗Checked
https://raw.githubusercontent.com/astral-sh/claude-code-plugins/f3ce88a7ba830f53afd6d944c1d0278ed318e142/LICENSE-APACHE
Supports: license, access.cost