Skip to content

aiskillstore/marketplace / skills/0xdarkmatter/python-env

python-env

Flagged

Fast Python environment management with uv (10-100x faster than pip). Triggers on: uv, venv, pip, pyproject, python environment, install package, dependencies.

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-12T09:27:20.517Z",
    "slug": "0xdarkmatter-python-env",
    "source_url": "https://github.com/0xDarkMatter/claude-mods/tree/main/skills/python-env",
    "source_ref": "main",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "3d541fb0623ffc58c96eb5000f40392086dcbcf98251931e325ec6f482ad4c25",
    "tree_hash": "6d4b914c8da5c9883af4b9fdb5a4b807c25bcfe922a7344d38916650a604de4d",
    "provenance": {
      "model_effective": "codex",
      "fallback_chain": [
        {
          "agent": "codex",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    }
  },
  "skill": {
    "name": "python-env",
    "description": "Guides uv-based Python environment setup, dependency management, project configuration, testing workflows, and package publishing.",
    "summary": "Manage reproducible Python projects and dependencies with uv.",
    "icon": "๐Ÿ“ฆ",
    "version": "1.0.2",
    "author": "0xDarkMatter",
    "license": "MIT",
    "tags": [
      "python",
      "uv",
      "dependencies",
      "virtual-environments",
      "pyproject"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "network",
      "filesystem",
      "external_commands",
      "env_access"
    ],
    "category": "devops"
  },
  "security_audit": {
    "risk_level": "critical",
    "is_blocked": true,
    "safe_to_publish": false,
    "analysis_status": "ok",
    "summary": "The audit confirmed one critical issue: SKILL.md recommends piping a remote installer directly into a shell. The other 87 findings are documentation examples or Markdown syntax without dangerous execution, access, or exfiltration intent.",
    "remediation": [
      {
        "issue": "The uv installation instruction executes a remote response directly in a shell.",
        "suggestion": "Recommend an approved package manager, or download the installer, verify its checksum, inspect it, and execute it as a separate step.",
        "severity": "critical"
      }
    ],
    "risk_factor_evidence": [
      {
        "factor": "network",
        "evidence": [
          {
            "file": "references/dependency-management.md",
            "line_start": 175,
            "line_end": 175
          },
          {
            "file": "references/dependency-management.md",
            "line_start": 194,
            "line_end": 194
          },
          {
            "file": "references/dependency-management.md",
            "line_start": 205,
            "line_end": 205
          },
          {
            "file": "references/dependency-management.md",
            "line_start": 206,
            "line_end": 206
          },
          {
            "file": "references/dependency-management.md",
            "line_start": 207,
            "line_end": 207
          },
          {
            "file": "references/dependency-management.md",
            "line_start": 214,
            "line_end": 214
          },
          {
            "file": "references/dependency-management.md",
            "line_start": 208,
            "line_end": 208
          },
          {
            "file": "references/publishing.md",
            "line_start": 47,
            "line_end": 47
          },
          {
            "file": "references/publishing.md",
            "line_start": 48,
            "line_end": 48
          },
          {
            "file": "references/publishing.md",
            "line_start": 49,
            "line_end": 49
          },
          {
            "file": "references/publishing.md",
            "line_start": 50,
            "line_end": 50
          },
          {
            "file": "references/publishing.md",
            "line_start": 77,
            "line_end": 77
          },
          {
            "file": "references/publishing.md",
            "line_start": 165,
            "line_end": 165
          },
          {
            "file": "references/publishing.md",
            "line_start": 166,
            "line_end": 166
          },
          {
            "file": "references/publishing.md",
            "line_start": 209,
            "line_end": 209
          },
          {
            "file": "references/pyproject-patterns.md",
            "line_start": 74,
            "line_end": 74
          },
          {
            "file": "references/pyproject-patterns.md",
            "line_start": 75,
            "line_end": 75
          },
          {
            "file": "references/pyproject-patterns.md",
            "line_start": 76,
            "line_end": 76
          },
          {
            "file": "references/pyproject-patterns.md",
            "line_start": 77,
            "line_end": 77
          },
          {
            "file": "SKILL.md",
            "line_start": 5,
            "line_end": 5
          }
        ]
      },
      {
        "factor": "filesystem",
        "evidence": [
          {
            "file": "references/dependency-management.md",
            "line_start": 228,
            "line_end": 228
          },
          {
            "file": "references/dependency-management.md",
            "line_start": 293,
            "line_end": 293
          },
          {
            "file": "references/dependency-management.md",
            "line_start": 293,
            "line_end": 293
          },
          {
            "file": "references/publishing.md",
            "line_start": 201,
            "line_end": 201
          },
          {
            "file": "references/publishing.md",
            "line_start": 201,
            "line_end": 201
          }
        ]
      },
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "references/publishing.md",
            "line_start": 62,
            "line_end": 81
          },
          {
            "file": "references/pyproject-patterns.md",
            "line_start": 52,
            "line_end": 53
          },
          {
            "file": "references/pyproject-patterns.md",
            "line_start": 53,
            "line_end": 63
          },
          {
            "file": "references/pyproject-patterns.md",
            "line_start": 63,
            "line_end": 78
          },
          {
            "file": "SKILL.md",
            "line_start": 14,
            "line_end": 14
          },
          {
            "file": "SKILL.md",
            "line_start": 15,
            "line_end": 15
          },
          {
            "file": "SKILL.md",
            "line_start": 21,
            "line_end": 21
          },
          {
            "file": "SKILL.md",
            "line_start": 22,
            "line_end": 22
          },
          {
            "file": "SKILL.md",
            "line_start": 23,
            "line_end": 23
          },
          {
            "file": "SKILL.md",
            "line_start": 24,
            "line_end": 24
          },
          {
            "file": "SKILL.md",
            "line_start": 25,
            "line_end": 25
          },
          {
            "file": "SKILL.md",
            "line_start": 26,
            "line_end": 26
          },
          {
            "file": "SKILL.md",
            "line_start": 27,
            "line_end": 27
          },
          {
            "file": "SKILL.md",
            "line_start": 28,
            "line_end": 28
          },
          {
            "file": "SKILL.md",
            "line_start": 29,
            "line_end": 29
          },
          {
            "file": "SKILL.md",
            "line_start": 33,
            "line_end": 40
          },
          {
            "file": "SKILL.md",
            "line_start": 40,
            "line_end": 42
          },
          {
            "file": "SKILL.md",
            "line_start": 42,
            "line_end": 42
          },
          {
            "file": "SKILL.md",
            "line_start": 43,
            "line_end": 43
          },
          {
            "file": "SKILL.md",
            "line_start": 48,
            "line_end": 66
          },
          {
            "file": "SKILL.md",
            "line_start": 66,
            "line_end": 68
          },
          {
            "file": "SKILL.md",
            "line_start": 68,
            "line_end": 68
          },
          {
            "file": "SKILL.md",
            "line_start": 69,
            "line_end": 73
          },
          {
            "file": "SKILL.md",
            "line_start": 73,
            "line_end": 76
          },
          {
            "file": "SKILL.md",
            "line_start": 76,
            "line_end": 77
          },
          {
            "file": "SKILL.md",
            "line_start": 77,
            "line_end": 79
          },
          {
            "file": "SKILL.md",
            "line_start": 79,
            "line_end": 79
          },
          {
            "file": "SKILL.md",
            "line_start": 80,
            "line_end": 84
          },
          {
            "file": "SKILL.md",
            "line_start": 84,
            "line_end": 88
          },
          {
            "file": "SKILL.md",
            "line_start": 88,
            "line_end": 90
          },
          {
            "file": "SKILL.md",
            "line_start": 90,
            "line_end": 90
          },
          {
            "file": "SKILL.md",
            "line_start": 91,
            "line_end": 95
          },
          {
            "file": "SKILL.md",
            "line_start": 95,
            "line_end": 99
          },
          {
            "file": "SKILL.md",
            "line_start": 99,
            "line_end": 103
          },
          {
            "file": "SKILL.md",
            "line_start": 103,
            "line_end": 107
          },
          {
            "file": "SKILL.md",
            "line_start": 107,
            "line_end": 117
          },
          {
            "file": "SKILL.md",
            "line_start": 117,
            "line_end": 124
          },
          {
            "file": "SKILL.md",
            "line_start": 124,
            "line_end": 126
          },
          {
            "file": "SKILL.md",
            "line_start": 126,
            "line_end": 128
          },
          {
            "file": "SKILL.md",
            "line_start": 128,
            "line_end": 129
          },
          {
            "file": "SKILL.md",
            "line_start": 129,
            "line_end": 130
          },
          {
            "file": "SKILL.md",
            "line_start": 130,
            "line_end": 130
          },
          {
            "file": "SKILL.md",
            "line_start": 133,
            "line_end": 138
          },
          {
            "file": "SKILL.md",
            "line_start": 138,
            "line_end": 144
          },
          {
            "file": "SKILL.md",
            "line_start": 144,
            "line_end": 145
          },
          {
            "file": "SKILL.md",
            "line_start": 145,
            "line_end": 145
          },
          {
            "file": "SKILL.md",
            "line_start": 146,
            "line_end": 147
          },
          {
            "file": "SKILL.md",
            "line_start": 147,
            "line_end": 148
          },
          {
            "file": "SKILL.md",
            "line_start": 148,
            "line_end": 153
          },
          {
            "file": "SKILL.md",
            "line_start": 153,
            "line_end": 153
          }
        ]
      },
      {
        "factor": "env_access",
        "evidence": [
          {
            "file": "references/pyproject-patterns.md",
            "line_start": 120,
            "line_end": 120
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "network:references/dependency-management.md:175:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/dependency-management.md",
        "line_start": 175,
        "line_end": 175,
        "snippet": "url = \"https://pypi.private.com/simple/\""
      },
      {
        "id": "network:references/dependency-management.md:194:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/dependency-management.md",
        "line_start": 194,
        "line_end": 194,
        "snippet": "--extra-index-url https://pypi.private.com/simple/"
      },
      {
        "id": "network:references/dependency-management.md:205:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/dependency-management.md",
        "line_start": 205,
        "line_end": 205,
        "snippet": "\"my-package @ git+https://github.com/user/repo.git\","
      },
      {
        "id": "network:references/dependency-management.md:206:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/dependency-management.md",
        "line_start": 206,
        "line_end": 206,
        "snippet": "\"my-package @ git+https://github.com/user/repo.git@v1.0.0\","
      },
      {
        "id": "network:references/dependency-management.md:207:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/dependency-management.md",
        "line_start": 207,
        "line_end": 207,
        "snippet": "\"my-package @ git+https://github.com/user/repo.git@main\","
      },
      {
        "id": "network:references/dependency-management.md:214:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/dependency-management.md",
        "line_start": 214,
        "line_end": 214,
        "snippet": "git+https://github.com/user/repo.git@main#egg=my-package"
      },
      {
        "id": "network:references/dependency-management.md:208:ssh-protocol-url",
        "category": "network",
        "severity": "medium",
        "pattern": "SSH protocol URL",
        "file": "references/dependency-management.md",
        "line_start": 208,
        "line_end": 208,
        "snippet": "\"my-package @ git+ssh://git@github.com/user/repo.git\","
      },
      {
        "id": "filesystem:references/dependency-management.md:228:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "references/dependency-management.md",
        "line_start": 228,
        "line_end": 228,
        "snippet": "my-local = { path = \"../my-local-package\" }"
      },
      {
        "id": "filesystem:references/dependency-management.md:293:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "references/dependency-management.md",
        "line_start": 293,
        "line_end": 293,
        "snippet": "path: ~/.cache/uv"
      },
      {
        "id": "filesystem:references/dependency-management.md:293:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/dependency-management.md",
        "line_start": 293,
        "line_end": 293,
        "snippet": "path: ~/.cache/uv"
      },
      {
        "id": "blocker:references/dependency-management.md:310:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/dependency-management.md",
        "line_start": 310,
        "line_end": 310,
        "snippet": "4. **Pin Python version** - Avoid compatibility surprises"
      },
      {
        "id": "external_commands:references/publishing.md:62:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "references/publishing.md",
        "line_start": 62,
        "line_end": 81,
        "snippet": "# Build sdist + wheel โ€” uv has a native builder, no separate `build` install"
      },
      {
        "id": "network:references/publishing.md:47:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/publishing.md",
        "line_start": 47,
        "line_end": 47,
        "snippet": "Homepage = \"https://github.com/username/my-package\""
      },
      {
        "id": "network:references/publishing.md:48:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/publishing.md",
        "line_start": 48,
        "line_end": 48,
        "snippet": "Documentation = \"https://my-package.readthedocs.io\""
      },
      {
        "id": "network:references/publishing.md:49:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/publishing.md",
        "line_start": 49,
        "line_end": 49,
        "snippet": "Repository = \"https://github.com/username/my-package\""
      },
      {
        "id": "network:references/publishing.md:50:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/publishing.md",
        "line_start": 50,
        "line_end": 50,
        "snippet": "Changelog = \"https://github.com/username/my-package/blob/main/CHANGELOG.md\""
      },
      {
        "id": "network:references/publishing.md:77:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/publishing.md",
        "line_start": 77,
        "line_end": 77,
        "snippet": "uv pip install --index-url https://test.pypi.org/simple/ my-package"
      },
      {
        "id": "network:references/publishing.md:165:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/publishing.md",
        "line_start": 165,
        "line_end": 165,
        "snippet": "[Unreleased]: https://github.com/user/repo/compare/v0.1.0...HEAD"
      },
      {
        "id": "network:references/publishing.md:166:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/publishing.md",
        "line_start": 166,
        "line_end": 166,
        "snippet": "[0.1.0]: https://github.com/user/repo/releases/tag/v0.1.0"
      },
      {
        "id": "network:references/publishing.md:209:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/publishing.md",
        "line_start": 209,
        "line_end": 209,
        "snippet": "repository = https://test.pypi.org/legacy/"
      },
      {
        "id": "filesystem:references/publishing.md:201:hidden-file-in-home-directory",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Hidden file in home directory",
        "file": "references/publishing.md",
        "line_start": 201,
        "line_end": 201,
        "snippet": "### ~/.pypirc (for twine)"
      },
      {
        "id": "filesystem:references/publishing.md:201:hidden-file-access",
        "category": "filesystem",
        "severity": "medium",
        "pattern": "Hidden file access",
        "file": "references/publishing.md",
        "line_start": 201,
        "line_end": 201,
        "snippet": "### ~/.pypirc (for twine)"
      },
      {
        "id": "sensitive:references/publishing.md:201:pypi-config-file-may-contain-tokens",
        "category": "sensitive",
        "severity": "high",
        "pattern": "PyPI config file (may contain tokens)",
        "file": "references/publishing.md",
        "line_start": 201,
        "line_end": 201,
        "snippet": "### ~/.pypirc (for twine)"
      },
      {
        "id": "blocker:references/publishing.md:77:non-standard-pypi-index",
        "category": "blocker",
        "severity": "high",
        "pattern": "Non-standard PyPI index",
        "file": "references/publishing.md",
        "line_start": 77,
        "line_end": 77,
        "snippet": "uv pip install --index-url https://test.pypi.org/simple/ my-package"
      },
      {
        "id": "external_commands:references/pyproject-patterns.md:52:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "references/pyproject-patterns.md",
        "line_start": 52,
        "line_end": 53,
        "snippet": "# Dev tooling โ†’ dependency-groups (PEP 735). `uv add --dev <pkg>` writes here;"
      },
      {
        "id": "external_commands:references/pyproject-patterns.md:53:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "references/pyproject-patterns.md",
        "line_start": 53,
        "line_end": 63,
        "snippet": "# `uv sync` installs it by default. Not shipped with the published package."
      },
      {
        "id": "external_commands:references/pyproject-patterns.md:63:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "references/pyproject-patterns.md",
        "line_start": 63,
        "line_end": 78,
        "snippet": "# Opt-in extras users install explicitly: `uv add \"my-package[docs]\"`"
      },
      {
        "id": "network:references/pyproject-patterns.md:74:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/pyproject-patterns.md",
        "line_start": 74,
        "line_end": 74,
        "snippet": "Homepage = \"https://github.com/username/my-package\""
      },
      {
        "id": "network:references/pyproject-patterns.md:75:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/pyproject-patterns.md",
        "line_start": 75,
        "line_end": 75,
        "snippet": "Documentation = \"https://my-package.readthedocs.io\""
      },
      {
        "id": "network:references/pyproject-patterns.md:76:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/pyproject-patterns.md",
        "line_start": 76,
        "line_end": 76,
        "snippet": "Repository = \"https://github.com/username/my-package\""
      },
      {
        "id": "network:references/pyproject-patterns.md:77:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "references/pyproject-patterns.md",
        "line_start": 77,
        "line_end": 77,
        "snippet": "Issues = \"https://github.com/username/my-package/issues\""
      },
      {
        "id": "env_access:references/pyproject-patterns.md:120:dotenv-library",
        "category": "env_access",
        "severity": "low",
        "pattern": "dotenv library",
        "file": "references/pyproject-patterns.md",
        "line_start": 120,
        "line_end": 120,
        "snippet": "\"python-dotenv>=1.0\","
      },
      {
        "id": "external_commands:SKILL.md:14:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 14,
        "line_end": 14,
        "snippet": "(`uv add` / `uv sync` / `uv run`) over the `uv pip` compatibility layer โ€” it"
      },
      {
        "id": "external_commands:SKILL.md:15:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 15,
        "line_end": 15,
        "snippet": "manages `pyproject.toml` + a lockfile for you and is reproducible."
      },
      {
        "id": "external_commands:SKILL.md:21:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 21,
        "line_end": 21,
        "snippet": "| Start a project | `uv init <name>` (app) ยท `uv init --package <name>` (installable, `src/` layout)"
      },
      {
        "id": "external_commands:SKILL.md:22:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 22,
        "line_end": 22,
        "snippet": "| Add dependency | `uv add httpx` |"
      },
      {
        "id": "external_commands:SKILL.md:23:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 23,
        "line_end": 23,
        "snippet": "| Add dev dependency | `uv add --dev pytest ruff` |"
      },
      {
        "id": "external_commands:SKILL.md:24:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 24,
        "line_end": 24,
        "snippet": "| Remove dependency | `uv remove httpx` |"
      },
      {
        "id": "external_commands:SKILL.md:25:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 25,
        "line_end": 25,
        "snippet": "| Sync env from lockfile | `uv sync` |"
      },
      {
        "id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 26,
        "line_end": 26,
        "snippet": "| Run in project env | `uv run pytest` |"
      },
      {
        "id": "external_commands:SKILL.md:27:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 27,
        "line_end": 27,
        "snippet": "| Update lockfile | `uv lock` |"
      },
      {
        "id": "external_commands:SKILL.md:28:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 28,
        "line_end": 28,
        "snippet": "| Install a CLI tool | `uv tool install ruff` ยท one-shot: `uvx ruff` |"
      },
      {
        "id": "external_commands:SKILL.md:29:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 29,
        "line_end": 29,
        "snippet": "| Install a Python | `uv python install 3.12` |"
      },
      {
        "id": "external_commands:SKILL.md:33:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 33,
        "line_end": 40,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:40:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 40,
        "line_end": 42,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:42:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 42,
        "line_end": 42,
        "snippet": "`uv init` creates `pyproject.toml`, pins a Python version, and prepares the"
      },
      {
        "id": "external_commands:SKILL.md:43:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 43,
        "line_end": 43,
        "snippet": "project for `uv add` / `uv sync`. The `--package` (src) layout is preferred for"
      },
      {
        "id": "external_commands:SKILL.md:48:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 48,
        "line_end": 66,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:66:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 66,
        "line_end": 68,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 68,
        "line_end": 68,
        "snippet": "`uv` creates and manages `.venv` automatically โ€” you rarely activate it; just"
      },
      {
        "id": "external_commands:SKILL.md:69:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 69,
        "line_end": 73,
        "snippet": "prefix commands with `uv run`."
      },
      {
        "id": "external_commands:SKILL.md:73:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 73,
        "line_end": 76,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:76:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 76,
        "line_end": 77,
        "snippet": "uv run -- ruff check .      # `--` ends uv flag parsing"
      },
      {
        "id": "external_commands:SKILL.md:77:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 77,
        "line_end": 79,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:79:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 79,
        "line_end": 79,
        "snippet": "Never call bare `python` / `pytest` / `ruff` in a uv project โ€” they may resolve"
      },
      {
        "id": "external_commands:SKILL.md:80:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 80,
        "line_end": 84,
        "snippet": "to a different interpreter. Always `uv run`."
      },
      {
        "id": "external_commands:SKILL.md:84:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 84,
        "line_end": 88,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:88:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 88,
        "line_end": 90,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:90:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 90,
        "line_end": 90,
        "snippet": "Use `uv tool` / `uvx` for developer CLIs (ruff, pre-commit, httpie). Use"
      },
      {
        "id": "external_commands:SKILL.md:91:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 91,
        "line_end": 95,
        "snippet": "`uv add` only for things your code imports."
      },
      {
        "id": "external_commands:SKILL.md:95:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 95,
        "line_end": 99,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:99:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 99,
        "line_end": 103,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:103:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 103,
        "line_end": 107,
        "snippet": "(TaskGroup, `Self`, faster interpreter)."
      },
      {
        "id": "external_commands:SKILL.md:107:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 107,
        "line_end": 117,
        "snippet": "```toml"
      },
      {
        "id": "external_commands:SKILL.md:117:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 117,
        "line_end": 124,
        "snippet": "# Dev deps live here; `uv add --dev <pkg>` manages this group."
      },
      {
        "id": "external_commands:SKILL.md:124:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 124,
        "line_end": 126,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:126:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 126,
        "line_end": 128,
        "snippet": "## Compatibility Layer (`uv pip`) โ€” last resort"
      },
      {
        "id": "external_commands:SKILL.md:128:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 128,
        "line_end": 129,
        "snippet": "`uv pip` mirrors pip's interface for environments uv doesn't manage (a hand-made"
      },
      {
        "id": "external_commands:SKILL.md:129:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 129,
        "line_end": 130,
        "snippet": "venv, a legacy `requirements.txt`, CI that isn't uv-native). It does **not**"
      },
      {
        "id": "external_commands:SKILL.md:130:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 130,
        "line_end": 130,
        "snippet": "update `pyproject.toml` or the lockfile โ€” prefer `uv add` / `uv sync` whenever"
      },
      {
        "id": "external_commands:SKILL.md:133:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 133,
        "line_end": 138,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:138:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 138,
        "line_end": 144,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:144:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 144,
        "line_end": 145,
        "snippet": "| \"No Python found\" | `uv python install 3.12` |"
      },
      {
        "id": "external_commands:SKILL.md:145:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 145,
        "line_end": 145,
        "snippet": "| Pin project Python | `uv init --python 3.12` or edit `requires-python` |"
      },
      {
        "id": "external_commands:SKILL.md:146:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 146,
        "line_end": 147,
        "snippet": "| Lock/resolve conflict | `uv lock --resolution=lowest-direct` to probe, then loosen bounds |"
      },
      {
        "id": "external_commands:SKILL.md:147:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 147,
        "line_end": 148,
        "snippet": "| Stale env after pull | `uv sync` |"
      },
      {
        "id": "external_commands:SKILL.md:148:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 148,
        "line_end": 153,
        "snippet": "| Cache issues | `uv cache clean` |"
      },
      {
        "id": "external_commands:SKILL.md:153:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 153,
        "line_end": 153,
        "snippet": "- `uv add` / `uv remove` / `uv sync` for project dependencies (not `uv pip install`)"
      },
      {
        "id": "external_commands:SKILL.md:154:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 154,
        "line_end": 155,
        "snippet": "- `uv run` to execute anything inside the project env"
      },
      {
        "id": "external_commands:SKILL.md:155:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 155,
        "line_end": 155,
        "snippet": "- `uv tool install` / `uvx` for standalone developer CLIs"
      },
      {
        "id": "external_commands:SKILL.md:156:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 156,
        "line_end": 161,
        "snippet": "- `uv pip` only for environments uv doesn't manage"
      },
      {
        "id": "external_commands:SKILL.md:161:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 161,
        "line_end": 162,
        "snippet": "- `./references/pyproject-patterns.md` - Full pyproject.toml examples, tool configs"
      },
      {
        "id": "external_commands:SKILL.md:162:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 162,
        "line_end": 163,
        "snippet": "- `./references/dependency-management.md` - Lock files, workspaces, private packages"
      },
      {
        "id": "external_commands:SKILL.md:163:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 163,
        "line_end": 172,
        "snippet": "- `./references/publishing.md` - PyPI publishing, versioning, CI/CD"
      },
      {
        "id": "external_commands:SKILL.md:172:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 172,
        "line_end": 173,
        "snippet": "- `python-typing-ops` - Type hints for projects"
      },
      {
        "id": "external_commands:SKILL.md:173:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 173,
        "line_end": 174,
        "snippet": "- `python-pytest-ops` - Testing infrastructure"
      },
      {
        "id": "network:SKILL.md:5:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 5,
        "line_end": 5,
        "snippet": "compatibility: \"Requires uv CLI tool. Install: curl -LsSf https://astral.sh/uv/install.sh | sh\""
      },
      {
        "id": "blocker:SKILL.md:5:pipe-to-shell-pattern",
        "category": "blocker",
        "severity": "critical",
        "pattern": "Pipe to shell pattern",
        "file": "SKILL.md",
        "line_start": 5,
        "line_end": 5,
        "snippet": "compatibility: \"Requires uv CLI tool. Install: curl -LsSf https://astral.sh/uv/install.sh | sh\""
      }
    ],
    "finding_verdicts": [
      {
        "id": "network:references/dependency-management.md:175:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is an illustrative package index or Git dependency URL in dependency-management documentation. It does not initiate a request or transmit data."
      },
      {
        "id": "network:references/dependency-management.md:194:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is an illustrative package index or Git dependency URL in dependency-management documentation. It does not initiate a request or transmit data."
      },
      {
        "id": "network:references/dependency-management.md:205:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is an illustrative package index or Git dependency URL in dependency-management documentation. It does not initiate a request or transmit data."
      },
      {
        "id": "network:references/dependency-management.md:206:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is an illustrative package index or Git dependency URL in dependency-management documentation. It does not initiate a request or transmit data."
      },
      {
        "id": "network:references/dependency-management.md:207:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is an illustrative package index or Git dependency URL in dependency-management documentation. It does not initiate a request or transmit data."
      },
      {
        "id": "network:references/dependency-management.md:214:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is an illustrative package index or Git dependency URL in dependency-management documentation. It does not initiate a request or transmit data."
      },
      {
        "id": "network:references/dependency-management.md:208:ssh-protocol-url",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The SSH URL is a placeholder showing valid Git dependency syntax. It neither embeds credentials nor targets an actual untrusted repository."
      },
      {
        "id": "filesystem:references/dependency-management.md:228:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The parent-directory path is a static example of a local sibling package dependency. No untrusted input controls the path, so this is not path traversal."
      },
      {
        "id": "filesystem:references/dependency-management.md:293:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The path names uv's standard cache directory in a GitHub Actions cache example. The skill does not read hidden files or access sensitive content."
      },
      {
        "id": "filesystem:references/dependency-management.md:293:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The path names uv's standard cache directory in a GitHub Actions cache example. The skill does not read hidden files or access sensitive content."
      },
      {
        "id": "blocker:references/dependency-management.md:310:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 1,
        "reason": "The cited text only recommends pinning a Python version. It performs no host, account, network, or environment discovery."
      },
      {
        "id": "external_commands:references/publishing.md:62:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "network:references/publishing.md:47:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is placeholder project metadata or an official TestPyPI endpoint in publishing documentation. It does not perform an undisclosed network request."
      },
      {
        "id": "network:references/publishing.md:48:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is placeholder project metadata or an official TestPyPI endpoint in publishing documentation. It does not perform an undisclosed network request."
      },
      {
        "id": "network:references/publishing.md:49:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is placeholder project metadata or an official TestPyPI endpoint in publishing documentation. It does not perform an undisclosed network request."
      },
      {
        "id": "network:references/publishing.md:50:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is placeholder project metadata or an official TestPyPI endpoint in publishing documentation. It does not perform an undisclosed network request."
      },
      {
        "id": "network:references/publishing.md:77:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is placeholder project metadata or an official TestPyPI endpoint in publishing documentation. It does not perform an undisclosed network request."
      },
      {
        "id": "network:references/publishing.md:165:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is placeholder project metadata or an official TestPyPI endpoint in publishing documentation. It does not perform an undisclosed network request."
      },
      {
        "id": "network:references/publishing.md:166:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is placeholder project metadata or an official TestPyPI endpoint in publishing documentation. It does not perform an undisclosed network request."
      },
      {
        "id": "network:references/publishing.md:209:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is placeholder project metadata or an official TestPyPI endpoint in publishing documentation. It does not perform an undisclosed network request."
      },
      {
        "id": "filesystem:references/publishing.md:201:hidden-file-in-home-directory",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The text documents the conventional twine configuration path and does not access the file. The shown values are placeholders, not collected credentials."
      },
      {
        "id": "filesystem:references/publishing.md:201:hidden-file-access",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The text documents the conventional twine configuration path and does not access the file. The shown values are placeholders, not collected credentials."
      },
      {
        "id": "sensitive:references/publishing.md:201:pypi-config-file-may-contain-tokens",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The documentation shows placeholder token values and recommends token-free trusted publishing. It does not contain, read, or exfiltrate an actual credential."
      },
      {
        "id": "blocker:references/publishing.md:77:non-standard-pypi-index",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The endpoint is the official TestPyPI staging index, used explicitly to test a package before production publication. It is not an unknown package source."
      },
      {
        "id": "external_commands:references/pyproject-patterns.md:52:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:references/pyproject-patterns.md:53:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:references/pyproject-patterns.md:63:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "network:references/pyproject-patterns.md:74:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The URL is placeholder project metadata inside a pyproject.toml example. No network operation or data transfer occurs."
      },
      {
        "id": "network:references/pyproject-patterns.md:75:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The URL is placeholder project metadata inside a pyproject.toml example. No network operation or data transfer occurs."
      },
      {
        "id": "network:references/pyproject-patterns.md:76:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The URL is placeholder project metadata inside a pyproject.toml example. No network operation or data transfer occurs."
      },
      {
        "id": "network:references/pyproject-patterns.md:77:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The URL is placeholder project metadata inside a pyproject.toml example. No network operation or data transfer occurs."
      },
      {
        "id": "env_access:references/pyproject-patterns.md:120:dotenv-library",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The line only declares python-dotenv as an example FastAPI dependency. It does not read environment variables, expose secrets, or transmit configuration."
      },
      {
        "id": "external_commands:SKILL.md:14:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:15:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:21:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:22:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:23:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:24:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:25:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:27:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:28:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:29:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:33:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:40:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:42:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:43:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:48:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:66:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:69:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:73:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:76:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:77:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:79:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:80:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:84:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:88:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:90:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:91:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:95:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:99:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:103:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:107:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:117:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:124:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:126:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:128:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:129:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:130:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:133:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:138:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:144:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:145:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:146:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:147:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:148:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:153:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:154:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:155:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:156:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:161:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:162:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:163:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:172:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "external_commands:SKILL.md:173:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The scanner matched Markdown backticks or fenced examples, not Ruby command substitution. The cited documentation contains no executable backtick expression."
      },
      {
        "id": "network:SKILL.md:5:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The URL is the documented Astral uv installer endpoint, not an unexplained or attacker-controlled destination. The separate pipe-to-shell finding captures the unsafe execution pattern."
      },
      {
        "id": "blocker:SKILL.md:5:pipe-to-shell-pattern",
        "verdict": "confirmed",
        "confidence": 0.99,
        "reason": "The compatibility instruction pipes a remote installer directly into a shell without integrity verification or inspection. A compromised response could execute arbitrary code.",
        "severity": "critical"
      }
    ],
    "semantic_findings": [],
    "critical_findings": [
      {
        "title": "Pipe to shell pattern",
        "description": "compatibility: \"Requires uv CLI tool. Install: curl -LsSf https://astral.sh/uv/install.sh | sh\"",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 5,
            "line_end": 5
          }
        ],
        "review_kind": "security",
        "source_category": "blocker",
        "source_severity": "critical",
        "confidence": 0.99,
        "confidence_reasoning": "The compatibility instruction pipes a remote installer directly into a shell without integrity verification or inspection. A compromised response could execute arbitrary code."
      }
    ],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [
      {
        "title": "Pipe to shell pattern",
        "description": "compatibility: \"Requires uv CLI tool. Install: curl -LsSf https://astral.sh/uv/install.sh | sh\"",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 5,
            "line_end": 5
          }
        ],
        "review_kind": "security",
        "source_category": "blocker",
        "source_severity": "critical",
        "confidence": 0.99,
        "confidence_reasoning": "The compatibility instruction pipes a remote installer directly into a shell without integrity verification or inspection. A compromised response could execute arbitrary code."
      }
    ],
    "files_scanned": 6,
    "total_lines": 1096,
    "audit_model": "codex",
    "audited_at": "2026-07-12T09:27:20.517Z",
    "agent_auto_install_policy": "blocked",
    "manual_install_policy": "allowed_with_warning"
  },
  "content": {
    "user_title": "Manage Python Environments with uv",
    "value_statement": "Python environments and dependency files can become slow, inconsistent, and difficult to reproduce. This skill provides practical uv workflows for setup, locking, testing, and publishing.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "Python uv",
      "Python environment management",
      "virtual environments",
      "pyproject.toml",
      "dependency locking",
      "Python package publishing",
      "TestPyPI"
    ],
    "actual_capabilities": [
      "Creates application and package projects with uv.",
      "Adds, removes, locks, and synchronizes Python dependencies.",
      "Runs Python, tests, and developer tools inside managed environments.",
      "Provides pyproject.toml patterns for applications, libraries, and tool configuration.",
      "Explains workspaces, private indexes, Git dependencies, and local dependencies.",
      "Guides package builds, TestPyPI checks, releases, and trusted publishing."
    ],
    "limitations": [
      "Requires the uv command-line tool and permission to change project files.",
      "Does not validate package trust, licenses, or vulnerability status.",
      "Publishing steps require repository and PyPI configuration outside this skill.",
      "Examples need adaptation for each operating system, index, and project policy."
    ],
    "use_cases": [
      {
        "title": "Start a Python project",
        "description": "Create a reproducible project with a suitable layout, Python version, dependencies, and development tools.",
        "target_user": "Python developers starting a new application or library"
      },
      {
        "title": "Modernize dependency workflows",
        "description": "Replace manual virtual environments and pip commands with uv project commands and a committed lockfile.",
        "target_user": "Maintainers updating an existing Python repository"
      },
      {
        "title": "Prepare a package release",
        "description": "Configure package metadata, build artifacts, test installation through TestPyPI, and use trusted publishing.",
        "target_user": "Release engineers publishing Python packages"
      }
    ],
    "prompt_templates": [
      {
        "title": "Create a basic environment",
        "prompt": "Set up this Python project with uv. Use Python [version], add [dependencies], and explain each proposed file change.",
        "scenario": "Beginner setup for an existing folder"
      },
      {
        "title": "Configure development tools",
        "prompt": "Add pytest, Ruff, and mypy to this uv project. Update pyproject.toml with practical defaults and run the appropriate checks.",
        "scenario": "Standard development environment"
      },
      {
        "title": "Migrate from pip",
        "prompt": "Migrate this repository from requirements files to a uv project workflow. Preserve constraints, separate development dependencies, and describe compatibility risks.",
        "scenario": "Intermediate dependency migration"
      },
      {
        "title": "Design a release workflow",
        "prompt": "Design a secure uv-based release workflow for this package. Include builds, TestPyPI validation, versioning, GitHub Actions, and PyPI trusted publishing.",
        "scenario": "Advanced package automation"
      }
    ],
    "output_examples": [
      {
        "input": "Create a Python 3.12 API project with FastAPI, pytest, and Ruff.",
        "output": "The response proposes a package layout, initializes Python 3.12, separates runtime and development dependencies, and lists validation steps."
      },
      {
        "input": "Convert this requirements-based project to uv.",
        "output": "The response maps direct dependencies into project metadata, creates development groups, generates a lockfile, and notes remaining legacy constraints."
      },
      {
        "input": "Prepare version 1.2.0 for publication.",
        "output": "The response checks metadata, changelog, tests, build artifacts, TestPyPI installation, release tags, and trusted publishing configuration."
      }
    ],
    "best_practices": [
      "Commit the lockfile and use frozen synchronization in continuous integration.",
      "Review dependency sources and version changes before installing or upgrading packages.",
      "Use PyPI trusted publishing instead of storing long-lived upload tokens."
    ],
    "anti_patterns": [
      "Do not pipe remote installation scripts directly into a shell.",
      "Do not mix bare Python commands with uv-managed project commands.",
      "Do not publish artifacts before testing their contents and installation."
    ],
    "faq": [
      {
        "question": "What does this skill require?",
        "answer": "It requires the uv command-line tool and a writable Python project directory."
      },
      {
        "question": "Does it replace pip?",
        "answer": "It prefers uv project commands but documents uv pip for legacy environments and requirements files."
      },
      {
        "question": "Can it create virtual environments?",
        "answer": "Yes. uv creates project environments automatically and can also create standalone virtual environments."
      },
      {
        "question": "Does it support monorepos?",
        "answer": "Yes. It includes uv workspace patterns for multiple packages that share one environment and lockfile."
      },
      {
        "question": "Can it publish packages?",
        "answer": "It guides building, TestPyPI validation, versioning, and PyPI publishing. External account and repository setup remain required."
      },
      {
        "question": "How does it handle secrets?",
        "answer": "It recommends trusted publishing and environment-based credentials. Users must protect local configuration and avoid committing tokens."
      }
    ]
  },
  "file_structure": [
    {
      "name": "assets",
      "type": "dir",
      "path": "assets",
      "children": [
        {
          "name": ".gitkeep",
          "type": "file",
          "path": "assets/.gitkeep",
          "lines": 0
        }
      ]
    },
    {
      "name": "references",
      "type": "dir",
      "path": "references",
      "children": [
        {
          "name": "dependency-management.md",
          "type": "file",
          "path": "references/dependency-management.md",
          "lines": 314
        },
        {
          "name": "publishing.md",
          "type": "file",
          "path": "references/publishing.md",
          "lines": 265
        },
        {
          "name": "pyproject-patterns.md",
          "type": "file",
          "path": "references/pyproject-patterns.md",
          "lines": 340
        }
      ]
    },
    {
      "name": "scripts",
      "type": "dir",
      "path": "scripts",
      "children": [
        {
          "name": ".gitkeep",
          "type": "file",
          "path": "scripts/.gitkeep",
          "lines": 0
        }
      ]
    },
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 175
    }
  ]
}
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 321kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 321kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 321kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 321kUpdated Claude CodeCodexVerifiedInstall