gitwtfhub

wtf is claude-code-plugins?

astral-sh/claude-code-plugins — explained in plain English

Analysis updated 2026-08-07 · repo last pushed 2026-02-27

296Audience · developerComplexity · 2/5MaintainedLicenseSetup · moderate

TL;DR

A Claude Code plugin that teaches the AI assistant to correctly use Astral's Python tools, uv, ruff, and ty, so it writes and edits Python code using current best practices instead of relying on potentially outdated general knowledge.

Mindmap

mindmap
  root((repo))
    What it does
      Guides Claude with uv
      Guides Claude with ruff
      Guides Claude with ty
    How it works
      Slash commands like astral uv
      Add reminder to CLAUDE.md
      Language server for ty types
    Audience
      Developers using Claude Code
      Teams sharing settings
    License
      Apache 2.0
      MIT

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Ensure Claude uses uv instead of pip for dependency management in Python projects.

REASON 2

Enforce consistent ruff linting and formatting conventions across a team using shared settings.

REASON 3

Help Claude understand type information in your code via the ty language server integration.

What's in the stack?

PythonClaude Code

How it stacks up

astral-sh/claude-code-pluginsxuzhougeng/wisp-scienceevolink-ai/awesome-blender-seedance-workflow-usecases
Stars296296295
LanguageHTMLPython
Last pushed2026-02-27
MaintenanceMaintained
Setup difficultymoderatehardmoderate
Complexity2/54/53/5
Audiencedeveloperresearcherdesigner

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 5min

Requires uvx to be installed on your system for the ty language server component to work.

Dual-licensed under Apache 2.0 and MIT, so you can use, modify, and distribute it freely for any purpose including commercial use.

Wtf does this do

This repository provides a plugin for Claude Code that helps the AI assistant work better with tools from Astral, the company behind popular Python development utilities like uv (a package manager), ruff (a code linter and formatter), and ty (a type checker). The plugin gives Claude built-in "skills" so it can follow current best practices when writing or editing Python code in your projects, rather than relying on its general training knowledge which might be outdated or incorrect. Once installed, you can trigger these skills by typing commands like /astral:uv in Claude Code. The plugin guides Claude to use the correct commands and conventions for each Astral tool. The README notes that Claude sometimes needs a nudge to actually use these skills, so it recommends adding a short instruction to your project's CLAUDE.md file reminding the assistant to invoke them when working with Python. The plugin also includes a language server component for ty, which helps Claude understand your code's types, though it requires uvx to be available on your system. The primary audience is developers or teams already using Claude Code for AI-assisted programming and who also use Astral's Python tools. For a solo developer, this means Claude will correctly use uv to manage dependencies instead of falling back to older tools like pip. For a team, a project maintainer can add the plugin to the project's shared settings file so that every teammate automatically gets the same plugin behavior, ensuring consistent code quality practices across the group. The project is notably designed to fit into Claude Code's marketplace system, allowing installation through simple commands or shared configuration files. Beyond the usage details provided, the README does not go into detail on the specific internal mechanics of how each skill is implemented, but the dual licensing under both Apache 2.0 and MIT makes it broadly permissive for anyone to use or contribute to.

Yoink these prompts

Prompt 1
Help me install and configure the Astral Claude Code plugin so Claude uses uv, ruff, and ty correctly in my Python project.
Prompt 2
Set up a shared CLAUDE.md instruction for my team so Claude always invokes the Astral plugin skills when editing Python code.
Prompt 3
Configure Claude Code to use the ty language server through this plugin so it can understand my project's type annotations.
Prompt 4
Explain how to add the Astral plugin to my project's shared settings file so all teammates get the same Python tooling behavior.

Frequently asked questions

wtf is claude-code-plugins?

A Claude Code plugin that teaches the AI assistant to correctly use Astral's Python tools, uv, ruff, and ty, so it writes and edits Python code using current best practices instead of relying on potentially outdated general knowledge.

Is claude-code-plugins actively maintained?

Maintained — commit in last 6 months (last push 2026-02-27).

What license does claude-code-plugins use?

Dual-licensed under Apache 2.0 and MIT, so you can use, modify, and distribute it freely for any purpose including commercial use.

How hard is claude-code-plugins to set up?

Setup difficulty is rated moderate, with roughly 5min to a first successful run.

Who is claude-code-plugins for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.