Problem: Same-name pollution: pip installs ivanzwb / multiple foreign repos with the same name —— Trove problem library

What you will run into

Following search results, you run pip install agent-skills and it installs an unrelated same-name project; or you clone jdrhyne/tristanmanchester/AkshitIreddy/mikeng-io/callstackincubator - same-name repos whose commands and artifacts match nothing.

Same-name pollution leads you astray.

Why this happens

• PyPI hosts a same-name ivanzwb package (CSDN case);
• GitHub hosts 5+ same-name repos (signals from abroad);
• The correct repo = addyosmani/agent-skills (manifest signature), with no pip distribution - the only install paths are npx and the codeload tarball.

Same-name pollution is essentially "a name is not a valid identity": every distribution channel (PyPI/GitHub/npm) only guarantees "this name is unique within this channel", never "this name belongs to only one project".

The same name can point to completely different projects across PyPI, GitHub and npm; search engines mix all three in front of you, and who ranks first depends on SEO, not identity.

Identity can only be judged by authority anchors inside each channel: on GitHub, the org name (addyosmani is the author himself, confirmed by manifest signature);

on PyPI, package ownership (agent-skills on PyPI belongs to ivanzwb, while this project has no pip distribution — whether a project has a distribution on a given channel is itself identity information).

So the install path is fixed: this project has only two official paths, npx and the codeload tarball; any tutorial telling you to pip install or clone another repo is a pollution source.

Cleanup after a wrong install also follows a fixed order: pip show/pip uninstall removes the same-name PyPI package -> check ~/.claude/skills/ for extra directories -> reinstall via the official path.

Step by step

1. Trust the repo and the install path — Required

npx skills add addyosmani/agent-skills

Or codeload: curl -sL https://gh-proxy.com/https://codeload.github.com/addyosmani/agent-skills/tar.gz/refs/tags/0.6.7 | tar xz.

2. Check whether you installed the wrong thing — Required

pip show agent-skills 2>/dev/null && pip uninstall agent-skills

If pip has this package, you hit ivanzwb - uninstall it.

3. Clean up wrong skill directories — Required

Check ~/.claude/skills/ for directories that are not this entry (copied from same-name repos) and remove them after confirming.

How to confirm it works

The correct skills directory exists (measured shape):

ls ~/.claude/skills/agent-skills
-> 24 subdirectories, each containing SKILL.md

pip list | grep agent-skills outputs nothing (the ivanzwb package is gone).

Other environments

Symptom

Following search results, pip install agent-skills installs an unrelated same-name project; or a clone lands on jdrhyne/tristanmanchester/AkshitIreddy/mikeng-io/callstackincubator - same-name repos whose commands/artifacts match nothing.

Cause

PyPI hosts the same-name ivanzwb package (CSDN case); GitHub hosts 5+ same-name repos (signals from abroad); the correct repo = addyosmani/agent-skills (manifest signature), no pip distribution - the only install paths are npx/codeload.

Solution

1. Trust the repo and install path: npx skills add addyosmani/agent-skills or the codeload addyosmani/agent-skills tag tarball; do not pip install.
2. If already misinstalled, uninstall the pip package and clean up the matching skill directory (non-this-entry dirs under ~/.claude/skills).