{
  "schemaVersion": "1.0",
  "item": {
    "slug": "uv-priority",
    "name": "Prioritize uv",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/marcoracer/uv-priority",
    "canonicalUrl": "https://clawhub.ai/marcoracer/uv-priority",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/uv-priority",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=uv-priority",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "skill.json",
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "uv-priority",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T09:48:02.348Z",
      "expiresAt": "2026-05-14T09:48:02.348Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=uv-priority",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=uv-priority",
        "contentDisposition": "attachment; filename=\"uv-priority-1.2.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "uv-priority"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/uv-priority"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/uv-priority",
    "agentPageUrl": "https://openagent3.xyz/skills/uv-priority/agent",
    "manifestUrl": "https://openagent3.xyz/skills/uv-priority/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/uv-priority/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "CRITICAL: Always Wrap Python Commands with uv or uvx",
        "body": "This is a mandatory skill for all Python-related tasks. When the user mentions Python, dbt, or ANY Python package, you MUST:\n\nNEVER run Python commands directly (python, python3, dbt, pytest, etc.)\nALWAYS wrap them with uv run or uvx\nNEVER install packages with pip install\nALWAYS use uv add or uv pip install"
      },
      {
        "title": "uv run vs uvx: When to Use Each",
        "body": "CommandWhen to UseExampleuv run <tool>Ferramenta do projeto - precisa importar seus módulos, usada regularmenteuv run pytest tests/uvx <tool>Utilitário externo - usa Python como runtime, mas não é parte do seu appuvx ruff check ."
      },
      {
        "title": "Quick Decision Guide",
        "body": "Preciso rodar uma ferramenta Python?\n├─ A ferramenta precisa importar meus módulos do projeto?\n│  └─ SIM → uv run <comando>\n└─ A ferramenta só analisa/transforma código externo?\n   └─ SIM → uvx <comando>"
      },
      {
        "title": "Use uvx for External Tools",
        "body": "uvx creates a temporary, isolated environment. Use it for tools that:\n\nAnalyze code without importing project modules (linters, formatters, type checkers)\nAre one-off utilities not tied to your project\nShouldn't pollute your project's dependencies\n\nuvx ruff check .          # Linter - analisa sintaxe, não importa seus módulos\nuvx black .               # Formatter - manipula texto, não importa seus módulos\nuvx mypy .                # Type checker - analisa tipos, não precisa rodar seu código\nuvx isort .               # Organizador de imports - só lê arquivos\nuvx ruff@latest check .   # Use specific version"
      },
      {
        "title": "Use uv run for Project Tools",
        "body": "uv run uses your project's existing virtual environment. Use it for tools that:\n\nNeed to import your project modules\nAre part of your development workflow with project dependencies\nRun tests or your application\n\nuv run pytest tests/      # Test runner - precisa importar seus módulos\nuv run python main.py     # Sua aplicação\nuv run python -m myapp.cli  # CLI do seu app\nuv run dbt run            # dbt com suas transformações do projeto"
      },
      {
        "title": "Rule of Consistency",
        "body": "If the project already uses uv run for a specific tool, continue using it.\n\nIf you see uv run ruff check . in the project, don't change to uvx\nIf the user specified uv run pytest, maintain the pattern\nProject consistency takes precedence over the \"ideal rule\"\n\nWhy? Changing from uv run to uvx (or vice-versa) mid-project can:\n\nBreak scripts/CI that expect the specific command\nConfuse other developers\nCreate unnecessary inconsistency"
      },
      {
        "title": "Command Translation Rules",
        "body": "NEVER run thisALWAYS run this insteadpython script.pyuv run python script.pypython -c \"import...\"uv run python -c \"import...\"python -m moduleuv run python -m modulepython3 script.pyuv run python3 script.pydbt --versionuv run dbt --versiondbt runuv run dbt rundbt debuguv run dbt debugdbt depsuv run dbt depspytestuv run pytest (imports project modules) or uvx pytest (one-off)pytest tests/uv run pytest tests/ (imports project modules) or uvx pytest tests/ (one-off)black .uvx black . (preferred - external tool) or uv run black . (if already in project)ruff check .uvx ruff check . (preferred - external tool) or uv run ruff check . (if already in project)mypy .uvx mypy . (preferred - external tool) or uv run mypy . (if already in project)pip install <package>uv add <package>pip install -r requirements.txtuv pip install -r requirements.txtpip listuv pip listpip freezeuv pip freeze"
      },
      {
        "title": "When to Use",
        "body": "Use when:\n\nInstalling ANY Python package or dependency (for ANY Python app: web apps, scripts, data processing, dbt, ML, etc.)\nSetting up Python projects (web apps like Flask/Django/FastAPI, data science, ML, automation, dbt, etc.)\nInstalling dependencies for ANY Python-based application\nCreating virtual environments\nRunning Python scripts\nRunning tests (pytest, unittest, etc.)\nUsing dbt commands (dbt-core, dbt-snowflake, etc.)\nANY task involving Python packages or dependencies"
      },
      {
        "title": "Command Substitutions (MANDATORY)",
        "body": "NEVER use these pip commands. ALWAYS use the uv equivalent:\n\nNEVER use pipALWAYS use uvpip install <package>uv add <package>pip install -r requirements.txtuv pip install -r requirements.txtpip listuv pip listpip freezeuv pip freeze"
      },
      {
        "title": "Popular Python Tools with CLI",
        "body": "These are commonly installed Python packages that have CLI commands. When installing or running them, always use uv:\n\nToolInstall with uvRun with uv (project)Run with uvx (external)dbt (dbt-core)uv add dbt-snowflake (or dbt-postgres)uv run dbt <command>-pytestuv add pytestuv run pytest (imports project modules)uvx pytest (one-off)black (formatter)uv add blackuv run black (if in project)uvx black . (preferred)ruff (linter)uv add ruffuv run ruff (if in project)uvx ruff check . (preferred)mypy (type checker)uv add mypyuv run mypy (if in project)uvx mypy . (preferred)flake8 (linter)uv add flake8uv run flake8uvx flake8pylint (linter)uv add pylintuv run pylintuvx pylintisort (import sorter)uv add isortuv run isortuvx isort .poetry (dependency manager)uv add poetryuv run poetryuvx poetrypipenv (dependency manager)uv add pipenvuv run pipenvuvx pipenvcookiecutter (project templates)uv add cookiecutteruv run cookiecutteruvx cookiecutterhttpie (HTTP client)uv add httpieuv run httpuvx httpmycli (MySQL CLI)uv add mycliuv run mycliuvx myclipgcli (PostgreSQL CLI)uv add pgcliuv run pgcliuvx pgcli\n\nNote: For linters, formatters, and type checkers, uvx is preferred (doesn't pollute project dependencies). For tools that need to import your project modules (like pytest with your app code), use uv run."
      },
      {
        "title": "Running Any Python Package CLI",
        "body": "For ANY Python package with a CLI command:\n\n# Option 1: Run as external tool (preferred for linters, formatters, one-off tools)\nuvx <cli-command>\n\n# Option 2: Install and run within project environment\nuv add <package>\nuv run <cli-command>\n\n# Option 3: Run with specific version\nuvx <package>@version <cli-command>"
      },
      {
        "title": "Environment and Scripts",
        "body": "NEVER use pipALWAYS use uvpython -m venv .venvuv venvpython script.pyuv run script.pypython -m moduleuv run python -m modulepython -m pip installuv addpython -m pip listuv pip list"
      },
      {
        "title": "Priority",
        "body": "uv (with uv run or uvx) is the ONLY option for Python package management and execution.\n\nExecution priority:\n\nuv run <command> - for tools that need project dependencies\nuvx <command> - for external tools that don't need project modules\n\nOnly consider pip as a fallback if:\n\nThe user explicitly requests pip\nuv is not available on the system\nYou receive explicit confirmation from the user"
      }
    ],
    "body": "UV Priority\nCRITICAL: Always Wrap Python Commands with uv or uvx\n\nThis is a mandatory skill for all Python-related tasks. When the user mentions Python, dbt, or ANY Python package, you MUST:\n\nNEVER run Python commands directly (python, python3, dbt, pytest, etc.)\nALWAYS wrap them with uv run or uvx\nNEVER install packages with pip install\nALWAYS use uv add or uv pip install\nuv run vs uvx: When to Use Each\nCommand\tWhen to Use\tExample\nuv run <tool>\tFerramenta do projeto - precisa importar seus módulos, usada regularmente\tuv run pytest tests/\nuvx <tool>\tUtilitário externo - usa Python como runtime, mas não é parte do seu app\tuvx ruff check .\nQuick Decision Guide\nPreciso rodar uma ferramenta Python?\n├─ A ferramenta precisa importar meus módulos do projeto?\n│  └─ SIM → uv run <comando>\n└─ A ferramenta só analisa/transforma código externo?\n   └─ SIM → uvx <comando>\n\nUse uvx for External Tools\n\nuvx creates a temporary, isolated environment. Use it for tools that:\n\nAnalyze code without importing project modules (linters, formatters, type checkers)\nAre one-off utilities not tied to your project\nShouldn't pollute your project's dependencies\nuvx ruff check .          # Linter - analisa sintaxe, não importa seus módulos\nuvx black .               # Formatter - manipula texto, não importa seus módulos\nuvx mypy .                # Type checker - analisa tipos, não precisa rodar seu código\nuvx isort .               # Organizador de imports - só lê arquivos\nuvx ruff@latest check .   # Use specific version\n\nUse uv run for Project Tools\n\nuv run uses your project's existing virtual environment. Use it for tools that:\n\nNeed to import your project modules\nAre part of your development workflow with project dependencies\nRun tests or your application\nuv run pytest tests/      # Test runner - precisa importar seus módulos\nuv run python main.py     # Sua aplicação\nuv run python -m myapp.cli  # CLI do seu app\nuv run dbt run            # dbt com suas transformações do projeto\n\nRule of Consistency\n\nIf the project already uses uv run for a specific tool, continue using it.\n\nIf you see uv run ruff check . in the project, don't change to uvx\nIf the user specified uv run pytest, maintain the pattern\nProject consistency takes precedence over the \"ideal rule\"\n\nWhy? Changing from uv run to uvx (or vice-versa) mid-project can:\n\nBreak scripts/CI that expect the specific command\nConfuse other developers\nCreate unnecessary inconsistency\nCommand Translation Rules\nNEVER run this\tALWAYS run this instead\npython script.py\tuv run python script.py\npython -c \"import...\"\tuv run python -c \"import...\"\npython -m module\tuv run python -m module\npython3 script.py\tuv run python3 script.py\ndbt --version\tuv run dbt --version\ndbt run\tuv run dbt run\ndbt debug\tuv run dbt debug\ndbt deps\tuv run dbt deps\npytest\tuv run pytest (imports project modules) or uvx pytest (one-off)\npytest tests/\tuv run pytest tests/ (imports project modules) or uvx pytest tests/ (one-off)\nblack .\tuvx black . (preferred - external tool) or uv run black . (if already in project)\nruff check .\tuvx ruff check . (preferred - external tool) or uv run ruff check . (if already in project)\nmypy .\tuvx mypy . (preferred - external tool) or uv run mypy . (if already in project)\npip install <package>\tuv add <package>\npip install -r requirements.txt\tuv pip install -r requirements.txt\npip list\tuv pip list\npip freeze\tuv pip freeze\nWhen to Use\n\nUse when:\n\nInstalling ANY Python package or dependency (for ANY Python app: web apps, scripts, data processing, dbt, ML, etc.)\nSetting up Python projects (web apps like Flask/Django/FastAPI, data science, ML, automation, dbt, etc.)\nInstalling dependencies for ANY Python-based application\nCreating virtual environments\nRunning Python scripts\nRunning tests (pytest, unittest, etc.)\nUsing dbt commands (dbt-core, dbt-snowflake, etc.)\nANY task involving Python packages or dependencies\nCommand Substitutions (MANDATORY)\n\nNEVER use these pip commands. ALWAYS use the uv equivalent:\n\nNEVER use pip\tALWAYS use uv\npip install <package>\tuv add <package>\npip install -r requirements.txt\tuv pip install -r requirements.txt\npip list\tuv pip list\npip freeze\tuv pip freeze\nPopular Python Tools with CLI\n\nThese are commonly installed Python packages that have CLI commands. When installing or running them, always use uv:\n\nTool\tInstall with uv\tRun with uv (project)\tRun with uvx (external)\ndbt (dbt-core)\tuv add dbt-snowflake (or dbt-postgres)\tuv run dbt <command>\t-\npytest\tuv add pytest\tuv run pytest (imports project modules)\tuvx pytest (one-off)\nblack (formatter)\tuv add black\tuv run black (if in project)\tuvx black . (preferred)\nruff (linter)\tuv add ruff\tuv run ruff (if in project)\tuvx ruff check . (preferred)\nmypy (type checker)\tuv add mypy\tuv run mypy (if in project)\tuvx mypy . (preferred)\nflake8 (linter)\tuv add flake8\tuv run flake8\tuvx flake8\npylint (linter)\tuv add pylint\tuv run pylint\tuvx pylint\nisort (import sorter)\tuv add isort\tuv run isort\tuvx isort .\npoetry (dependency manager)\tuv add poetry\tuv run poetry\tuvx poetry\npipenv (dependency manager)\tuv add pipenv\tuv run pipenv\tuvx pipenv\ncookiecutter (project templates)\tuv add cookiecutter\tuv run cookiecutter\tuvx cookiecutter\nhttpie (HTTP client)\tuv add httpie\tuv run http\tuvx http\nmycli (MySQL CLI)\tuv add mycli\tuv run mycli\tuvx mycli\npgcli (PostgreSQL CLI)\tuv add pgcli\tuv run pgcli\tuvx pgcli\n\nNote: For linters, formatters, and type checkers, uvx is preferred (doesn't pollute project dependencies). For tools that need to import your project modules (like pytest with your app code), use uv run.\n\nRunning Any Python Package CLI\n\nFor ANY Python package with a CLI command:\n\n# Option 1: Run as external tool (preferred for linters, formatters, one-off tools)\nuvx <cli-command>\n\n# Option 2: Install and run within project environment\nuv add <package>\nuv run <cli-command>\n\n# Option 3: Run with specific version\nuvx <package>@version <cli-command>\n\nEnvironment and Scripts\nNEVER use pip\tALWAYS use uv\npython -m venv .venv\tuv venv\npython script.py\tuv run script.py\npython -m module\tuv run python -m module\npython -m pip install\tuv add\npython -m pip list\tuv pip list\nPriority\n\nuv (with uv run or uvx) is the ONLY option for Python package management and execution.\n\nExecution priority:\n\nuv run <command> - for tools that need project dependencies\nuvx <command> - for external tools that don't need project modules\n\nOnly consider pip as a fallback if:\n\nThe user explicitly requests pip\nuv is not available on the system\nYou receive explicit confirmation from the user"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/marcoracer/uv-priority",
    "publisherUrl": "https://clawhub.ai/marcoracer/uv-priority",
    "owner": "marcoracer",
    "version": "1.2.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/uv-priority",
    "downloadUrl": "https://openagent3.xyz/downloads/uv-priority",
    "agentUrl": "https://openagent3.xyz/skills/uv-priority/agent",
    "manifestUrl": "https://openagent3.xyz/skills/uv-priority/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/uv-priority/agent.md"
  }
}