basic_uv — uv project management basic_uv, default-python-project, community, uv project management, ide skills, ty type checks, pyproject.toml configuration, uv.lock file management, basic_uv install, project management with uv and ty, Claude Code

v1.0.0
GitHub

About this Skill

Ideal for Python Development Agents requiring precise project management with uv and ty for efficient workflow and accurate type checks. basic_uv is a project management skill that utilizes uv as the project package manager and runner, and ty for type checks, to ensure efficient and accurate project workflow.

Features

Detects uv project state by checking for pyproject.toml and uv.lock files
Syncs project environment with uv sync command
Runs tools through uv to ensure project environment usage
Supports running python scripts and modules with uv run python command
Provides command-first guidance for accurate project management

# Core Topics

uv project management ty type checks pyproject.toml configuration uv.lock file management basic_uv install project management with uv and ty
Silviase Silviase
[0]
[0]
Updated: 3/8/2026

Agent Capability Analysis

The basic_uv skill by Silviase is an open-source community AI agent skill for Claude Code and other IDE workflows, helping agents execute tasks with better context, repeatability, and domain-specific guidance. Optimized for uv project management, ty type checks, pyproject.toml configuration.

Ideal Agent Persona

Ideal for Python Development Agents requiring precise project management with uv and ty for efficient workflow and accurate type checks.

Core Value

Empowers agents to manage projects with uv as the package manager and runner, and ty for type checks, ensuring accuracy and efficiency in workflows involving pyproject.toml and uv.lock files through commands like uv sync and uv run.

↓ Capabilities Granted for basic_uv

Automating project setup with uv and ty
Debugging type errors using ty
Optimizing project workflows with uv sync and uv run commands

! Prerequisites & Limits

  • Requires pyproject.toml and uv.lock files
  • Python environment required
  • uv and ty installations necessary
Labs Demo

Browser Sandbox Environment

⚡️ Ready to unleash?

Experience this Agent in a zero-setup browser environment powered by WebContainers. No installation required.

Boot Container Sandbox

basic_uv

Install basic_uv, an AI agent skill for AI agent workflows and automation. Works with Claude Code, Cursor, and Windsurf with one-command setup.

SKILL.md
Readonly

Basic uv / ty

Overview

Use uv as the project package manager and runner; use ty for type checks. Provide command-first guidance and state what each command changes (pyproject.toml, uv.lock, or the virtual environment).

Workflow

  • Detect uv project state by checking for pyproject.toml and uv.lock.
  • Sync before running tools when accuracy matters: uv sync.
  • Run tools through uv to ensure the project environment is used: uv run <cmd>.
  • Prefer uv run python <script_or_module> over plain python when coding or executing Python in this repo.
  • Call out side effects explicitly: uv add/remove update pyproject.toml and uv.lock; uv sync changes the environment.

Common uv Commands

  • Initialize a project: uv init
  • Add deps: uv add <pkg>; dev deps: uv add --dev <pkg>; group deps: uv add --group <group> <pkg>
  • Remove deps: uv remove <pkg>
  • Lock deps: uv lock (update uv.lock); uv lock --check (CI check); uv lock --upgrade (allow upgrades)
  • Sync env: uv sync; uv sync --frozen (do not update uv.lock); uv sync --group <group> (include group)
  • Run commands: uv run <cmd>; uv run --no-sync <cmd> (skip sync); uv run --group <group> <cmd>
  • Inspect deps: uv tree
  • Export lockfile: uv export
  • Manage Python installs: uv python list|install|find|pin
  • Tool runner: uv tool run <pkg> <cmd>; install: uv tool install <pkg>
  • pip-compat mode: uv pip install|compile|sync|list|freeze|check

Common ty Commands

  • Type check: uv run ty check [PATHS]
  • Watch mode: uv run ty check --watch
  • Config override: uv run ty check --config KEY=VALUE
  • Config file: uv run ty check --config-file path/to/ty.toml
  • Exclude paths: uv run ty check --exclude 'pattern'
  • Target Python: uv run ty check --python-version 3.12
  • Specify env: uv run ty check --python path/to/python
  • LSP server: uv run ty server
  • Shell completion: ty generate-shell-completion <SHELL>

Project Reference

  • If the repo provides a local cheat sheet, consult it for project-specific conventions: docs/ty-uv-commands.md.

FAQ & Installation Steps

These questions and steps mirror the structured data on this page for better search understanding.

? Frequently Asked Questions

What is basic_uv?

Ideal for Python Development Agents requiring precise project management with uv and ty for efficient workflow and accurate type checks. basic_uv is a project management skill that utilizes uv as the project package manager and runner, and ty for type checks, to ensure efficient and accurate project workflow.

How do I install basic_uv?

Run the command: npx killer-skills add Silviase/default-python-project/basic_uv. It works with Cursor, Windsurf, VS Code, Claude Code, and 19+ other IDEs.

What are the use cases for basic_uv?

Key use cases include: Automating project setup with uv and ty, Debugging type errors using ty, Optimizing project workflows with uv sync and uv run commands.

Which IDEs are compatible with basic_uv?

This skill is compatible with Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer. Use the Killer-Skills CLI for universal one-command installation.

Are there any limitations for basic_uv?

Requires pyproject.toml and uv.lock files. Python environment required. uv and ty installations necessary.

↓ How To Install

  1. 1. Open your terminal

    Open the terminal or command line in your project directory.

  2. 2. Run the install command

    Run: npx killer-skills add Silviase/default-python-project/basic_uv. The CLI will automatically detect your IDE or AI agent and configure the skill.

  3. 3. Start using the skill

    The skill is now active. Your AI agent can use basic_uv immediately in the current project.

Related Skills

Looking for an alternative to basic_uv or another community skill for your workflow? Explore these related open-source skills.

View All

widget-generator

Logo of f
f

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.

★ 149.6k
⑂ 0
AI

flags

Logo of vercel
vercel

flags is a Next.js feature management skill that enables developers to efficiently add or modify framework feature flags, streamlining React application development.

★ 138.4k
⑂ 0
Browser

zustand

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

★ 72.8k
⑂ 0
AI

data-fetching

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

★ 72.8k
⑂ 0
AI