From 2ab14b100fe77323077542d30dde7da08c2b88a1 Mon Sep 17 00:00:00 2001 From: Sebastian Mendel Date: Tue, 8 Sep 2026 00:59:28 +0200 Subject: [PATCH 1/2] docs: complete the marketplace setup steps The README named the catalog correctly but stopped one step short: it never documented the `/plugin install` line, so following it left you with a registered marketplace and no plugin. The install target is the catalog entry name `cli-tools`, which is not always the repo name. Also documents the marketplace-free route from Claude Code 2.1.157 ("Plugins in .claude/skills directories are now automatically loaded, no marketplace required"), which loads hooks, agents and commands in place. Canonical template corrected in netresearch/skill-repo-skill#291. Assisted-by: claude-code:claude-opus-5 Agent-Session: https://claude.ai/code/session_01L94yEWSBvuUkLqLpVbMqRh Agent-Host: 0493f0 Signed-off-by: Sebastian Mendel --- README.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/README.md b/README.md index 0dabf86..8409497 100644 --- a/README.md +++ b/README.md @@ -59,8 +59,20 @@ Add the [Netresearch marketplace](https://github.com/netresearch/claude-code-mar ```bash # Claude Code /plugin marketplace add netresearch/claude-code-marketplace +/plugin install cli-tools@netresearch-claude-code-marketplace ``` +### Without a marketplace + +Since Claude Code 2.1.157 a plugin directory under your personal skills directory loads on its own, hooks and commands included: + +```bash +git clone https://github.com/netresearch/cli-tools-skill.git \ + ~/.claude/skills/cli-tools +``` + +It loads as `cli-tools@skills-dir` on the next session. Update with `git pull`; remove it by deleting the directory. This route has no `claude plugin update`. + ### npx ([skills.sh](https://skills.sh)) Install with any [Agent Skills](https://agentskills.io)-compatible agent: @@ -76,6 +88,8 @@ Download the [latest release](https://github.com/netresearch/cli-tools-skill/rel ### Git Clone ```bash + +> **Limitation:** `npx skills` installs `SKILL.md`-based skills only. This repo also ships `hooks`, which it does not install — use the marketplace or the skills directory for those. git clone https://github.com/netresearch/cli-tools-skill.git ``` From 5d672c49fe416ad05b81fd57d59bf77bd507fcf3 Mon Sep 17 00:00:00 2001 From: Sebastian Mendel Date: Wed, 9 Sep 2026 00:21:26 +0200 Subject: [PATCH 2/2] docs: correct the skills-directory install instructions MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Review on this PR found four defects in the section it adds: - The limitation note sat inside the `bash` fence under "Git Clone", so it rendered as shell input and would be copied along with the command. It now sits after the npx example, which is what it is about. - `git clone` into `~/.claude/skills/` fails on a fresh setup where that parent does not exist; `mkdir -p ~/.claude/skills` precedes it. - "Update with `git pull`" ran wherever the reader happened to stand. It now names the directory and says a new session is needed for the change to load. - The sentence claimed hooks and commands unconditionally. It now names only what this repository actually ships. The skills-directory route itself is kept. The review argued it should be dropped because `.claude-plugin/plugin.json` lists only `skills`, but that key is not how hooks are discovered: of twelve installed plugins carrying a `hooks/` directory — Anthropic's own among them — none declares `hooks` in its `plugin.json`. `hooks/hooks.json` is loaded by convention, so its absence from the manifest proves nothing. Assisted-by: claude-code:claude-opus-5 Agent-Session: https://claude.ai/code/session_01Gcm3GRuYBxJGtyj7qviJF8 Agent-Host: 0493f0 Signed-off-by: Sebastian Mendel --- README.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 8409497..9655548 100644 --- a/README.md +++ b/README.md @@ -64,14 +64,15 @@ Add the [Netresearch marketplace](https://github.com/netresearch/claude-code-mar ### Without a marketplace -Since Claude Code 2.1.157 a plugin directory under your personal skills directory loads on its own, hooks and commands included: +Since Claude Code 2.1.157 a plugin directory under your personal skills directory loads on its own, including the hooks this repo ships: ```bash +mkdir -p ~/.claude/skills git clone https://github.com/netresearch/cli-tools-skill.git \ ~/.claude/skills/cli-tools ``` -It loads as `cli-tools@skills-dir` on the next session. Update with `git pull`; remove it by deleting the directory. This route has no `claude plugin update`. +It loads as `cli-tools@skills-dir` on the next session. Update with `git -C ~/.claude/skills/cli-tools pull` and start a new session; remove it by deleting the directory. This route has no `claude plugin update`. ### npx ([skills.sh](https://skills.sh)) @@ -81,6 +82,8 @@ Install with any [Agent Skills](https://agentskills.io)-compatible agent: npx skills add https://github.com/netresearch/cli-tools-skill --skill cli-tools ``` +> **Limitation:** `npx skills` installs `SKILL.md`-based skills only. This repo also ships `hooks`, which it does not install — use the marketplace or the skills directory for those. + ### Download Release Download the [latest release](https://github.com/netresearch/cli-tools-skill/releases/latest) and extract to your agent's skills directory. @@ -88,8 +91,6 @@ Download the [latest release](https://github.com/netresearch/cli-tools-skill/rel ### Git Clone ```bash - -> **Limitation:** `npx skills` installs `SKILL.md`-based skills only. This repo also ships `hooks`, which it does not install — use the marketplace or the skills directory for those. git clone https://github.com/netresearch/cli-tools-skill.git ```