Configure Package Management

/configure:package-management

Check and configure modern package managers for optimal development experience.

When to Use This Skill

Context

• Project root: !pwd
• Package files: !find . -maxdepth 1 \( -name 'package.json' -o -name 'pyproject.toml' -o -name 'Cargo.toml' -o -name 'go.mod' \)
• Lock files: !find . -maxdepth 1 \( -name 'uv.lock' -o -name 'bun.lockb' -o -name 'package-lock.json' -o -name 'yarn.lock' -o -name 'pnpm-lock.yaml' -o -name 'poetry.lock' -o -name 'Pipfile.lock' \)
• Python venv: !find . -maxdepth 1 -type d -name '.venv'
• Legacy files: !find . -maxdepth 1 \( -name 'requirements.txt' -o -name 'Pipfile' \)
• Project standards: !find . -maxdepth 1 -name '.project-standards.yaml'

Parameters

Parse from command arguments:

• --check-only: Report compliance status without modifications (CI/CD mode)
• --fix: Apply fixes automatically without prompting
• --manager <uv|bun|npm|cargo>: Override detection (focus on specific manager)

Modern package manager preferences:

• Python: uv (replaces pip, poetry, pipenv, pyenv) - 10-100x faster
• JavaScript/TypeScript: bun (alternative to npm/yarn/pnpm) - significantly faster
• Rust: cargo (standard, no alternatives needed)
• Go: go mod (standard, no alternatives needed)

Execution

Execute this package management compliance check:

Step 1: Detect project languages and current package managers

Check for language and manager indicators:

Use WebSearch or WebFetch to verify latest versions before configuring.

Step 2: Analyze current configuration state

For each detected language, check configuration:

Python (uv):

• uv installed and on PATH
• pyproject.toml exists with [project] section
• uv.lock exists (lock file)
• Virtual environment in .venv/
• Python version pinned in pyproject.toml
• Dependency groups configured (dev, test, docs)
• Build system specified (hatchling, setuptools, etc.)

JavaScript/TypeScript (bun):

• bun installed and on PATH
• package.json exists
• bun.lockb exists (lock file)
• node_modules/ exists
• Scripts defined (dev, build, test, lint)
• Type definitions configured (TypeScript)
• Workspaces configured (if monorepo)

Step 3: Generate compliance report

Print a formatted compliance report:

Package Management Configuration Report
=======================================
Project: [name]
Languages: Python, TypeScript

Python:
  Package manager           uv 0.5.x                   [MODERN | LEGACY pip]
  pyproject.toml            exists                     [EXISTS | MISSING]
  Lock file                 uv.lock                    [EXISTS | OUTDATED | MISSING]
  Virtual environment       .venv/                     [EXISTS | MISSING]
  Python version            3.12                       [PINNED | NOT PINNED]
  Dependency groups         dev, test, docs            [CONFIGURED | MINIMAL]
  Build backend             hatchling                  [CONFIGURED | MISSING]

JavaScript/TypeScript:
  Package manager           bun 1.1.x                  [MODERN | npm | yarn]
  package.json              exists                     [EXISTS | MISSING]
  Lock file                 bun.lockb                  [EXISTS | MISSING]
  Scripts                   dev, build, test, lint     [COMPLETE | INCOMPLETE]
  Type definitions          tsconfig.json              [CONFIGURED | MISSING]
  Engine constraints        package.json engines       [PINNED | NOT PINNED]

Overall: [X issues found]

Recommendations:
  - Migrate from pip to uv for faster installs
  - Add uv.lock to version control
  - Configure dependency groups in pyproject.toml
  - Migrate from npm to bun for better performance

If --check-only, stop here.

Step 4: Configure package managers (if --fix or user confirms)

Apply configuration based on detected languages. Use templates from REFERENCE.md:

Python with uv

1. Install uv (via mise, curl, or homebrew)
2. Initialize project with uv init or migrate from existing manager
3. Create/update pyproject.toml with project metadata and dependency groups
4. Generate uv.lock
5. Update .gitignore

JavaScript/TypeScript with bun

1. Install bun (via mise, curl, or homebrew)
2. Remove old lock files (package-lock.json, yarn.lock, pnpm-lock.yaml)
3. Run bun install to generate bun.lockb
4. Update scripts in package.json
5. Update .gitignore

Step 5: Handle migrations

If migrating from a legacy manager:

pip/poetry to uv:

1. Install uv
2. Run uv init
3. Migrate dependencies: uv add -r requirements.txt or copy from poetry
4. Remove old files (requirements.txt, Pipfile, poetry.lock)
5. Update CI/CD workflows

npm/yarn/pnpm to bun:

1. Install bun
2. Remove old lock files and node_modules
3. Run bun install
4. Update scripts to use bun equivalents
5. Update CI/CD workflows

Use migration templates from REFERENCE.md.

Step 6: Configure CI/CD integration

Update GitHub Actions workflows to use modern package managers:

• Python: Replace pip install with astral-sh/setup-uv@v8 + uv sync
• JavaScript: Replace actions/setup-node with oven-sh/setup-bun@v2

Use CI workflow templates from REFERENCE.md.

Step 7: Update standards tracking

Update .project-standards.yaml:

standards_version: "2025.1"
last_configured: "[timestamp]"
components:
  package_management: "2025.1"
  python_package_manager: "uv"
  javascript_package_manager: "bun"
  lock_files_committed: true

Step 8: Print final report

Print a summary of changes applied, migrations performed, and next steps for verifying the configuration.

For detailed configuration templates and migration guides, see REFERENCE.md.

Agentic Optimizations

Flags

Examples

# Check compliance and offer migrations
/configure:package-management

# Check only, no modifications
/configure:package-management --check-only

# Auto-migrate Python to uv
/configure:package-management --fix --manager uv

# Auto-migrate JavaScript to bun
/configure:package-management --fix --manager bun

Error Handling

• Multiple Python managers detected: Warn about conflict, suggest single source of truth
• Missing package manager: Offer to install via mise
• Invalid pyproject.toml: Report parse error, offer template
• Lock file conflicts: Warn about multiple lock files, suggest cleanup
• Workspace/monorepo: Detect and configure workspace settings

See Also

• /configure:linting - Configure linting tools (ruff, biome)
• /configure:formatting - Configure formatters
• /deps:install - Universal dependency installer
• /configure:all - Run all compliance checks
• uv documentation: https://docs.astral.sh/uv
• bun documentation: https://bun.sh/docs