Still, I don't get fully on how to use this repo

[thees]

The Readme says that I can install individually plugins. On the other hand the global AGENTS.md talks about "cross-harness skills" and references i.e. docs/agents.md where all agents are listed.

So, should claude pick the appropriate plugins by itself by reading agents.md etc? (there is also "auto-discovery" mentioned in AGENTS.md)
If so, how should the installation be done by the user?

Initially I thought I pick per project my set of say 10 skills I might be using in my project, but then auto-discovery cannot work.

it would be nice to clarify and add this to the readme.md.

[wshobson]

Fair question — the two docs describe different layers and never say so explicitly. The short version:

1. You install per plugin, not per skill. /plugin marketplace add wshobson/agents registers the catalog (loads nothing into context). /plugin install <plugin> is the unit of installation — each plugin brings its own agents, commands, and skills.
2. Auto-discovery operates inside what you installed. Once a plugin is installed, Claude Code discovers its skills automatically and activates them when your task matches a skill's description. You never pick 10 skills by hand — you pick the 2–3 plugins covering your domain, and their skills self-activate.
3. AGENTS.md / docs/agents.md are the catalog, not an install mechanism. They exist so you (and other harnesses) can browse what's available; reading them doesn't wire anything up.

So for your case: choose the plugins whose skill lists cover your project (e.g. python-development + developer-essentials), install those, and auto-discovery handles the rest. A "How installation actually works" section is being added to docs/usage.md to make this explicit — thanks for flagging it.

[wshobson]

The docs section I mentioned is now in docs/usage.md under "How Installation Actually Works". It explains that you install whole plugins, and that skills inside them load on their own when a task matches. I'm closing this, but if anything there is still unclear, please open an issue and we'll fix the docs.