Agent skill

Uv

by BiFangKNT in BiFangKNT/mtga

在 Windows/macOS/Linux 上使用 uv 执行 Python 运行、依赖同步、锁文件管理、Python 版本管理与工具命令(uv run、uv sync、uv lock、uv python、uv tool)。当任务涉及“用 uv 运行脚本/命令”“临时依赖(--with)”“锁文件一致性(--locked/--frozen)”“跨平台…

AGPL-3.0Auto-check passed

Install Uv

skills CLI
$ npx skills add BiFangKNT/mtga --skill uv -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install BiFangKNT/mtga uv --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/BiFangKNT/mtga.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/uv .claude/skills/uv && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
uv
GitHub stars
1.2k
Token cost
~541 tokens
SKILL.md length
172 words
Files
8 (incl. references)
Skills in repo
6
Repo updated
First seen
Licence
AGPL-3.0

At a glance

在 Windows/macOS/Linux 上使用 uv 执行 Python 运行、依赖同步、锁文件管理、Python 版本管理与工具命令(uv run、uv sync、uv lock、uv python、uv tool)。当任务涉及“用 uv 运行脚本/命令”“临时依赖(--with)”“锁文件一致性(--locked/--frozen)”“跨平台…

  • Works in 5 steps: 确认上下文:当前目录是否为 pyproject.toml… → 先选操作面:运行命令(run)、同步环境(sync)、更新锁(lock)、Pyth… → 先执行只读探测:版本、help、检查状态(如 uv --version、uv… → …
  • SKILL.md covers Overview, Workflow, Operation Decision and Command Rules, plus 4 more sections
  • Calls uv

What it does

Uv is an agent skill from BiFangKNT/mtga. 在 Windows/macOS/Linux 上使用 uv 执行 Python 运行、依赖同步、锁文件管理、Python 版本管理与工具命令(uv run、uv sync、uv lock、uv python、uv tool)。当任务涉及“用 uv 运行脚本/命令”“临时依赖(--with)”“锁文件一致性(--locked/--frozen)”“跨平台 shell(bash/zsh/PowerShell)下排查 uv 执行问题”时使用此 skill。

Its SKILL.md is about 540 tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including reference files (for example `agents/openai.yaml`, `references/commands.md` and `references/python.md`).

It works with Python, Bash, PowerShell and Linux. The repository describes itself as: 基于本地代理的方式,绕过 IDE 的固定模型服务商限制. The licence is AGPL-3.0.

Example prompts

  • “用 uv 运行脚本/命令”
  • “临时依赖(--with)”
  • “锁文件一致性(--locked/--frozen)”
  • “/uv”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. 确认上下文:当前目录是否为 pyproject.toml 项目、是否允许改动锁文件和环境。
  2. 先选操作面:运行命令(run)、同步环境(sync)、更新锁(lock)、Python 版本(python)、工具(tool)。
  3. 先执行只读探测:版本、help、检查状态(如 uv --version、uv lock --check、uv sync --check)。
  4. 再执行变更命令:明确写入范围(uv.lock、.venv、.python-version、工具目录)。
  5. 输出关键结果与下一步。

What it can do on your machine

Read from SKILL.md and the folder at commit 72669fb. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Uv loads about 541 tokens when it runs, and up to ~1.3k if it reads all its reference files. Until then it costs about 62 tokens; SKILL.md has 172 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~62
When it runs · the whole SKILL.md, loaded when a task matches
~541
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from BiFangKNT/mtga at commit 72669fb, republished under its AGPL-3.0 licence (© BiFangKNT). 172 words, ~541 tokens.

Download SKILL.mdSave it as .claude/skills/uv/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
uv
description
在 Windows/macOS/Linux 上使用 `uv` 执行 Python 运行、依赖同步、锁文件管理、Python 版本管理与工具命令(`uv run`、`uv sync`、`uv lock`、`uv python`、`uv tool`)。当任务涉及“用 uv 运行脚本/命令”“临时依赖(`--with`)”“锁文件一致性(`--locked`/`--frozen`)”“跨平台 shell(bash/zsh/PowerShell)下排查 uv 执行问题”时使用此 skill。

Uv

Overview

以可复现、可审计的方式使用 uv。优先给出最小可执行命令,先读状态后做写入,明确是否会修改 uv.lock、.venv、.python-version。

Workflow

  1. 确认上下文:当前目录是否为 pyproject.toml 项目、是否允许改动锁文件和环境。
  2. 先选操作面:运行命令(run)、同步环境(sync)、更新锁(lock)、Python 版本(python)、工具(tool)。
  3. 先执行只读探测:版本、help、检查状态(如 uv --version、uv lock --check、uv sync --check)。
  4. 再执行变更命令:明确写入范围(uv.lock、.venv、.python-version、工具目录)。
  5. 输出关键结果与下一步。

Operation Decision

  1. 只执行一次命令且不想持久安装工具:用 uv tool run(或 uvx)。
  2. 在项目环境中执行代码/命令:用 uv run。
  3. 需要补齐或重建项目环境:用 uv sync。
  4. 需要检查或更新锁文件:用 uv lock(只检查用 uv lock --check)。
  5. 需要固定解释器版本:用 uv python install + uv python pin。

Command Rules

  • uv 选项必须放在被执行命令之前;必要时用 -- 分隔(例如 uv run --python 3.12 -- python)。
  • 需要临时依赖时用 uv run --with <pkg> 或 uv tool run --with <pkg>。
  • 不希望自动发现项目时用 --no-project。
  • uv run/uv sync 默认会处理 lock/sync;需要禁止写锁文件时优先 --locked,需要跳过锁文件更新检查时用 --frozen。
  • 执行 Python 脚本工具(如校验脚本)缺依赖时,优先 uv run --with pyyaml <script>。
  • 在 Windows 下出现 Python 默认编码导致的 UnicodeDecodeError 时,可先设置 $env:PYTHONUTF8='1' 后再运行 uv run ...。

Failure Handling

  • 命令不存在或子命令写错:先运行对应 --help,再重试最小命令。
  • No module named ...:改为 uv run --with <missing-package> ...。
  • --locked 失败(锁文件过期):先 uv lock 或 uv sync 更新,再重试。
  • 目录不是项目却执行了项目命令:改用 --no-project 或切换到正确项目目录。
  • PowerShell 环境变量导致参数展开异常:优先使用单引号和显式变量赋值。

Safety Checklist

执行会写入的命令前,先确认:

  • 当前仓库/目录是否正确。
  • 是否允许修改 uv.lock 与 .venv。
  • 是否允许写入 .python-version。
  • 是否为一次性命令(应使用 uv tool run)还是持久安装(uv tool install)。

Output Format

统一按以下结构输出:

  1. Plan: 本次要完成的 uv 任务。
  2. Commands: 实际执行命令(先只读,后变更)。
  3. Result: 关键结果(是否改动锁文件/环境、关键版本、状态检查结果)。
  4. Next: 失败时的最短可执行下一步。

Reference

按需读取参考文档:

  • 命令索引:references/commands.md
  • 运行与临时依赖:references/run.md
  • 锁与同步:references/sync-lock.md
  • Python 版本管理:references/python.md
  • 工具命令:references/tool.md
  • 常见故障:references/troubleshooting.md

© BiFangKNT, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (references) in .codex/skills/uv of BiFangKNT/mtga.

  • SKILL.md
  • agents/openai.yaml
  • references/commands.md
  • references/python.md
  • references/run.md
  • references/sync-lock.md
  • references/tool.md
  • references/troubleshooting.md

Open the folder on GitHubat commit 72669fb

Compare with similar skills

Uv next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Uv compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Uv this skillBiFangKNT/mtga1.2k—~541Automated safety check: PassAGPL-3.0
Environment SetupNorman-bury/research-writing-skill3.4k—~840Automated safety check: PassMIT
Tbtoolsxuzhougeng/wispterm443—~2.3kAutomated safety check: PassMIT
Remote Hostslibnativeapi/nativeapi162—~1.3kAutomated safety check: PassMIT
Adu Motion Videoadunext/adu-motion-video192—~2.3kAutomated safety check: PassMIT
Local Asrysyecust/lecture-to-notes273—~1.6kAutomated safety check: PassCustom licence

Similar skills

  • Environment Setup

    Norman-bury/research-writing-skill

    A skill your agent uses when Python environment setup is needed for data visualization or conda installation is required

    3.4k GitHub stars~840 tokensUpdated 4 mo ago
    Data & AnalyticsAuto-check passed
  • Tbtools

    xuzhougeng/wispterm

    A skill your agent uses when the user asks about TBtools, TBtools-II, TBtools RPC API, TBtools CLI, or bioinformatics operations available through TBtools such as sequence manipulation, BLAST…

    443 GitHub stars~2.3k tokensUpdated 3 days ago
    Research & ScienceAuto-check passed
  • Remote Hosts

    libnativeapi/nativeapi

    Build, run, and GUI-test on another machine over SSH — the user's Windows laptop today, Linux or other macOS machines tomorrow — with one symmetric CLI for every OS: push scripts, run them either in…

    162 GitHub stars~1.3k tokensUpdated today
    MobileAuto-check passed
  • Adu Motion Video

    adunext/adu-motion-video

    使用完整动画工程包,把新口播、文案与自有素材制作成可编辑动效视频和 60fps MP4;也支持轻量 TPL、手绘续接、字幕与改旧片。支持 Windows、macOS、Linux,以及 Codex、Claude Code、豆包、DeepSeek、WorkBuddy 等可读写文件并运行命令的助手。

    192 GitHub stars~2.3k tokensUpdated 2 days ago
    Auto-check passed
  • Local Asr

    ysyecust/lecture-to-notes

    把本地长视频/音频转写成文字稿 + 可选字幕,纯本地(不上传云端),用 sherpa-onnx X-ASR Zipformer transducer 模型(int8 量化、中英双语、自动标点)。已在 macOS Apple Silicon(int8 + AMX,~100× 实时)、Linux ARM64(CPU,~32× 实时)与 Windows(PowerShell…

    273 GitHub stars~1.6k tokensUpdated 6 days ago
    AI & LLM EngineeringAuto-check passed
  • Cross Platform Paths

    microsoft/vscode-python-environments

    Official

    Critical patterns for cross-platform path handling in this VS Code extension.

    141 GitHub stars~1.5k tokensUpdated today
    Testing & QAAuto-check passed

More from BiFangKNT/mtga

  • Ast Grep

    BiFangKNT/mtga

    Write and debug ast-grep rules for structural code search and rewrite.

    1.2k GitHub stars~802 tokensUpdated 3 mo ago
    Auto-check passed
  • Trae Native Debug

    BiFangKNT/mtga

    Maintain, debug, and recover MTGA's Trae native custom-model route.

    1.2k GitHub stars~920 tokensUpdated 3 mo ago
    Auto-check passed
  • Gh CLI

    BiFangKNT/mtga

    使用 GitHub CLI (gh) 执行非交互式 GitHub 协作与自动化任务(PR、Issue、Actions、Release、API 查询/修改)。当用户要求“用 gh 命令完成任务”、需要结构化 JSON 输出(--json/--jq)、批量处理 PR/Issue(如“批量 review 多个 PR”)、按策略合并(如“检查通过后自动 squash 合并”)时使用此 skill。

    1.2k GitHub stars~599 tokensUpdated 3 mo ago
    Auto-check passed
  • Tauri

    BiFangKNT/mtga

    构建、调试与发布 Tauri v2 应用的工程化工作流。覆盖项目初始化(create-tauri-app)、前端与 Rust 命令通信([tauri::command] + invoke)、状态管理、Capabilities 权限建模、插件接入、跨平台构建与问题排查。当用户需求涉及“创建 Tauri 项目”“把 Web 前端接到 Rust…

    1.2k GitHub stars~466 tokensUpdated 3 mo ago
    Auto-check passed
  • Pwsh

    BiFangKNT/mtga

    在 Windows PowerShell 5.1 与 PowerShell 7 中编写和执行稳定命令,重点处理引号、管道符、原生命令参数传递与跨版本兼容。遇到 --jq/过滤表达式被 PowerShell 误解析、同一命令在 pwsh5 与 pwsh7 行为不一致、或需要为 pwsh7.3+ 增加参数传递适配时使用此 skill。

    1.2k GitHub stars~338 tokensUpdated 3 mo ago
    Auto-check passed

Questions about Uv

What does Uv do?

在 Windows/macOS/Linux 上使用 uv 执行 Python 运行、依赖同步、锁文件管理、Python 版本管理与工具命令(uv run、uv sync、uv lock、uv python、uv tool)。当任务涉及“用 uv 运行脚本/命令”“临时依赖(--with)”“锁文件一致性(--locked/--frozen)”“跨平台…. Uv is an agent skill from BiFangKNT/mtga.

How do I install Uv in Claude Code?

Run `npx skills add BiFangKNT/mtga --skill uv -a claude-code`. Or copy the skill folder (.codex/skills/uv in BiFangKNT/mtga) into .claude/skills/uv in your project. Claude Code loads it when a task matches its description.

How do I install Uv in Codex?

Run `npx skills add BiFangKNT/mtga --skill uv -a codex`. Or copy the skill folder (.codex/skills/uv in BiFangKNT/mtga) into .agents/skills/uv in your project. Codex loads it when a task matches its description.

Can I use Uv in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add BiFangKNT/mtga --skill uv -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/uv, .gemini/skills/uv, .github/skills/uv and .opencode/skills/uv in your project.

What does Uv need to run?

Going by SKILL.md and its folder, Uv needs the command-line tools its instructions call (uv). Our summary lists: Python 3.

Does Uv access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Uv safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Uv use?

Uv is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Uv use?

About 541 tokens (SKILL.md is roughly 2.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 713 tokens, read only when the agent opens those files.

What are the alternatives to Uv?

Skills that share tags, products or a category with Uv: Environment Setup (Norman-bury/research-writing-skill, 3.4k stars), Tbtools (xuzhougeng/wispterm, 443 stars), Remote Hosts (libnativeapi/nativeapi, 162 stars) and Adu Motion Video (adunext/adu-motion-video, 192 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Uv?

BiFangKNT (a GitHub user) maintains it in BiFangKNT/mtga, which has 1,169 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on June 18, 2026.

Source: BiFangKNT/mtga on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.