From f07b995481ef28a1eef30a2339a3023dfbe5620a Mon Sep 17 00:00:00 2001 From: gas2own Date: Thu, 16 Jul 2026 19:57:24 +0000 Subject: [PATCH] README: clarify Claude Code marketplace install steps Users hit "Plugin not found in any marketplace" because the marketplace-add was an unmarked prerequisite and the install commands lacked the `@asta-plugins` qualifier that Claude Code auto-complete offers. Number the steps, use the fully-qualified install form, and document that a `marketplace update` fails when the marketplace was previously removed (re-add first). Co-Authored-By: Claude Opus 4.8 --- README.md | 23 +++++++++++++++++++---- 1 file changed, 19 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index da39944..057b094 100644 --- a/README.md +++ b/README.md @@ -41,13 +41,28 @@ npx plugins add allenai/asta-plugins npx skills add allenai/asta-plugins -g # Claude Code marketplace (alternative to npx plugins) +# 1. Add this repo as a plugin marketplace. This step is required first — +# the plugins can't be installed until their marketplace is registered. > /plugin marketplace add allenai/asta-plugins -> /plugin install asta-tools -> /plugin install asta-flows # optional, for multi-step workflows -> /plugin install asta-assistant # optional, for autonomous research -> /plugin install asta-dev # optional, for contributors + +# 2. Install the plugins you want. The `@asta-plugins` suffix names the +# marketplace added above and is what Claude Code's auto-complete offers. +> /plugin install asta-tools@asta-plugins +> /plugin install asta-flows@asta-plugins # optional, for multi-step workflows +> /plugin install asta-assistant@asta-plugins # optional, for autonomous research +> /plugin install asta-dev@asta-plugins # optional, for contributors +``` + +To pull the latest version later, update the marketplace: + +```commandline +> /plugin marketplace update asta-plugins ``` +If your marketplace list is empty (for example, you previously removed +`asta-plugins`), `update` won't find it — re-add it first with +`/plugin marketplace add allenai/asta-plugins`, then re-run the installs above. + ## Asta CLI The skills install an `asta` CLI tool, which has sub-commands for the various research functions.