Skip to content

ComeOnOliver/skillshub / skills/aiskillstore/marketplace/89jobrien/python-scripting

python-scripting

Flagged

Python scripting with uv and PEP 723 inline dependencies. Use when creating standalone Python scripts with automatic dependency management.

FileKindSize
SKILL.mdskill md1.3 KB
references/uv-script.template.pyscript1.4 KB
skill-report.jsonconfig8.4 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-01-16T13:56:43.079Z",
    "slug": "89jobrien-python-scripting",
    "source_url": "https://github.com/89jobrien/steve/tree/main/steve/skills/python-scripting",
    "source_ref": "main",
    "model": "claude",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "1f23c23c7b15d62723738790c9f4139b5ba8c0eb5ca8232fc9f5562154a67bc0",
    "tree_hash": "312a895c00cce8b66ed4fe971ec7baad7e4ce029a1b994d6194b929525565dc5"
  },
  "skill": {
    "name": "python-scripting",
    "description": "Python scripting with uv and PEP 723 inline dependencies. Use when creating standalone Python scripts with automatic dependency management.",
    "summary": "Python scripting with uv and PEP 723 inline dependencies. Use when creating standalone Python script...",
    "icon": "🐍",
    "version": "1.0.1",
    "author": "Joseph OBrien",
    "license": "MIT",
    "category": "coding",
    "tags": [
      "python",
      "scripting",
      "automation",
      "uv",
      "cli"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "scripts"
    ]
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "summary": "Template-based skill providing a Python script template. Contains no executable code that runs on installation. All 23 static findings are false positives: template placeholders, documentation URLs, and metadata strings were misidentified as security patterns. The skill only generates template code when invoked by the user.",
    "risk_factor_evidence": [
      {
        "factor": "scripts",
        "evidence": [
          {
            "file": "references/uv-script.template.py",
            "line_start": 1,
            "line_end": 73
          }
        ]
      }
    ],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 3,
    "total_lines": 343,
    "audit_model": "claude",
    "audited_at": "2026-01-16T13:56:43.079Z"
  },
  "content": {
    "user_title": "Create Python Scripts with uv",
    "value_statement": "Writing standalone Python scripts with dependencies requires manual setup and configuration. This skill generates ready-to-run scripts with PEP 723 inline metadata, automatic dependency management, and proper CLI argument parsing.",
    "seo_keywords": [
      "python scripting",
      "uv python",
      "pep 723",
      "inline dependencies",
      "python automation",
      "cli scripts",
      "claude python",
      "codex python",
      "claude code python",
      "python template"
    ],
    "actual_capabilities": [
      "Generates standalone Python scripts with PEP 723 inline metadata",
      "Configures automatic dependency installation via uv",
      "Sets up argparse CLI argument parsing",
      "Creates reproducible builds with exclude-newer timestamp",
      "Supports input and output file handling",
      "Provides verbose logging mode"
    ],
    "limitations": [
      "Requires uv and Python 3.12+ installed on the system",
      "Only creates scripts - does not execute them",
      "Template placeholders must be filled in by the AI or user",
      "No built-in support for complex dependency resolution"
    ],
    "use_cases": [
      {
        "target_user": "DevOps engineers",
        "title": "Automation scripts",
        "description": "Create reproducible automation scripts for deployment, data processing, and system maintenance tasks."
      },
      {
        "target_user": "Data analysts",
        "title": "Data processing pipelines",
        "description": "Build standalone data processing scripts with required libraries installed automatically on first run."
      },
      {
        "target_user": "Developer tools",
        "title": "CLI utilities",
        "description": "Generate command-line tools with proper argument parsing and help documentation."
      }
    ],
    "prompt_templates": [
      {
        "title": "Basic script",
        "scenario": "Create a simple utility script",
        "prompt": "Create a Python script named 'hello.py' that prints a greeting message. Use requests for HTTP calls and rich for formatted output."
      },
      {
        "title": "Data processing",
        "scenario": "Process a data file",
        "prompt": "Create a script 'process_data.py' that reads a CSV file, calculates summary statistics using pandas, and outputs results to JSON format."
      },
      {
        "title": "API client",
        "scenario": "Build an API client tool",
        "prompt": "Create 'api_client.py' that takes a URL as input, makes a GET request using httpx, and displays the response in pretty-printed JSON format."
      },
      {
        "title": "File converter",
        "scenario": "Convert between formats",
        "prompt": "Create 'convert.py' that converts JSON files to YAML. Support input file and output file as arguments. Use pyyaml for conversion."
      }
    ],
    "output_examples": [
      {
        "input": "Create a Python script that fetches weather data and displays it nicely.",
        "output": [
          "Generated weather.py with requests and rich dependencies",
          "Added argparse for --city and --output arguments",
          "Included PEP 723 inline metadata block",
          "Set exclude-newer for reproducible builds",
          "Run with: uv run weather.py --city London"
        ]
      },
      {
        "input": "Create a script to convert CSV files to JSON format.",
        "output": [
          "Created csv_to_json.py with pandas dependency",
          "Added --input and --output file arguments",
          "Included help documentation in docstring",
          "Set Python 3.12+ requirement in metadata",
          "Run with: uv run csv_to_json.py --input data.csv --output data.json"
        ]
      },
      {
        "input": "Create a backup script that copies files with timestamp.",
        "output": [
          "Generated backup.py with shutil and datetime imports",
          "Added --source and --destination arguments",
          "Included verbose mode for progress display",
          "Added error handling with exit codes",
          "Run with: uv run backup.py --verbose /path/to/source /path/to/dest"
        ]
      }
    ],
    "best_practices": [
      "Include exclude-newer in PEP 723 metadata for reproducible builds across time.",
      "Add docstrings with usage examples so users understand how to run the script.",
      "Use argparse with --help to provide clear command-line documentation."
    ],
    "anti_patterns": [
      "Hardcoding API keys or credentials in script templates.",
      "Skipping the docstring and usage examples section.",
      "Making scripts do too many unrelated tasks - keep them focused."
    ],
    "faq": [
      {
        "question": "What Python version is required?",
        "answer": "Python 3.12 or higher is required for PEP 723 inline script support."
      },
      {
        "question": "Where does uv install dependencies?",
        "answer": "uv creates an isolated virtual environment for each script and installs dependencies there."
      },
      {
        "question": "Can I use this skill without uv installed?",
        "answer": "No, uv must be installed. Install via: curl -LsSf https://astral.sh/uv/install.sh | sh"
      },
      {
        "question": "Is my data safe when running these scripts?",
        "answer": "Yes. The skill only generates template code. Scripts run locally with your permissions."
      },
      {
        "question": "Why am I getting a 'command not found' error?",
        "answer": "Ensure uv is in your PATH. Add export PATH=\"$HOME/.local/bin:$PATH\" to your shell config."
      },
      {
        "question": "How is this different from a regular Python virtual environment?",
        "answer": "uv scripts inline all dependencies in the file itself, eliminating separate requirements.txt or environment.yml files."
      }
    ]
  },
  "file_structure": [
    {
      "name": "references",
      "type": "dir",
      "path": "references",
      "children": [
        {
          "name": "uv-script.template.py",
          "type": "file",
          "path": "references/uv-script.template.py",
          "lines": 73
        }
      ]
    },
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 65
    }
  ]
}
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: 319kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 319kUpdated 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: 319kUpdated 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: 319kUpdated Claude CodeCodexVerifiedInstall