pypi-collision-fix

Fix PyPI package name collisions by installing optional dependencies directly without extras syntax.

3|Updated Dec 10, 2025
One-click install
npx skills add https://github.com/smith6jt-cop/Skills_Registry --skill pypi-collision-fix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pypi-collision-fix
Source: https://github.com/smith6jt-cop/Skills_Registry/tree/main/plugins/general/pypi-collision-fix/skills/pypi-collision-fix
Command: npx skills add https://github.com/smith6jt-cop/Skills_Registry --skill pypi-collision-fix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill fixes silent package installation failures where pip downloads the wrong package from PyPI instead of using your local development version.

Core Features & Use Cases

  • Direct Package Installation: Bypasses PyPI extras resolution that causes conflicts.
  • Use Case: When your local package installs are being overwritten by unrelated PyPI packages.

Quick Start

Fix the PyPI package name collision for the current development environment.

Quick Start

Fix the PyPI collision issue when installing optional dependencies for your project.

Frequently Asked Questions about pypi-collision-fix

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix PyPI package name collisions in my local Python project?

PyPI package name collisions occur when your local package shares a name with a PyPI package, causing pip to download the wrong version during editable installs. This Skill resolves collisions by implementing direct package name installations and bypassing the package[extra] syntax to keep your local development version active.

Why is pip installing the wrong package when I use pip install -e . with optional dependencies?

When installing optional dependencies using extras syntax (package[extra]), pip may resolve to a PyPI package instead of your local version if a name collision exists. This Skill fixes it by enforcing direct package installations that bypass extras resolution, ensuring your local package remains active.

Can I resolve PyPI collisions for extras like bio or gpu without renaming my package?

Yes. This Skill handles extras resolution conflicts (bio, gpu, etc.) by updating CLI and workflow logic to use direct package name installations instead of the package[extra] syntax, preventing PyPI from overwriting your local development version.

When should I use direct package installation over extras syntax for dependencies?

Use direct package installation when your local package name exists on PyPI and you're using editable installs with optional dependencies. This approach prevents silent package conflicts where pip pulls from PyPI instead of your local development version.

What's the difference between fixing package collisions and managing regular pip dependencies?

Regular pip dependency management handles version conflicts; collision fixing addresses a specific failure mode where local and PyPI package names collide, causing pip to silently install the wrong package. This Skill prevents that by enforcing local package precedence.