From e22989a556267ad1e6838546122ef5fded81c80f Mon Sep 17 00:00:00 2001 From: Nikolai Emil Damm Date: Sat, 18 Jul 2026 09:16:24 +0200 Subject: [PATCH 1/2] docs: document the npx skills path for agents outside the big three MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The README only covered VS Code, Copilot CLI and Claude Code, so anyone on one of the other 70+ agents `npx skills` supports had no documented way in — even though the path already works today. Verified live: `npx skills add devantler-tech/agent-plugins` reads this repo's .claude-plugin/marketplace.json via the CLI's plugin-manifest discovery and resolves all 27 bundled skills, matching the on-disk count exactly. Documented as an explicitly PARTIAL path, because it is: an install pulls the skills but NOT the 1 bundled MCP server config or the 4 custom agents — those are plugin-level resources only a real plugin install delivers. Confirmed by installing a skill and checking what landed (skill files only). Overstating this as a full install path would send people to a worse experience than the three first-class tools. --- README.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/README.md b/README.md index 56fed01..c5a7044 100644 --- a/README.md +++ b/README.md @@ -57,6 +57,21 @@ Add the marketplace, then install a plugin — run these inside Claude Code: Browse everything on offer with `/plugin` (**Discover** tab) or list it with `/plugin list`. The bundled [`.claude-plugin/marketplace.json`](.claude-plugin/marketplace.json) is also discovered automatically when this repo is added as a plugin source. +### Any other agent — skills only, via `npx skills` + +[`npx skills`](https://github.com/vercel-labs/skills) reads this repo's [`.claude-plugin/marketplace.json`](.claude-plugin/marketplace.json) and installs the bundled **skills** into any of its 70+ supported agents — useful when your agent isn't one of the three above: + +```sh +# Browse the bundled skills without installing +npx skills add devantler-tech/agent-plugins --list + +# Install specific skills for a specific agent +npx skills add devantler-tech/agent-plugins --skill gitops-knowledge --agent cursor +``` + +> [!IMPORTANT] +> This is a **partial** install path. It resolves all **27 bundled skills**, but **not** the [MCP servers](#mcp-servers) or [custom agents](#custom-agents) — those are plugin-level resources that only a real plugin install delivers. For the complete plugins, use VS Code, Copilot CLI, or Claude Code above. + ## MCP servers A plugin may bundle [MCP](https://modelcontextprotocol.io) servers as well as skills. The From a1d1eef9f5e85b0c7d73f86a11b48f392e8e7ca5 Mon Sep 17 00:00:00 2001 From: Nikolai Emil Damm Date: Sat, 18 Jul 2026 09:31:48 +0200 Subject: [PATCH 2/2] docs: don't call VS Code a complete-plugin install path MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The partial-path note sent people to "VS Code, Copilot CLI, or Claude Code" for the complete plugins, but this README's own MCP servers and Custom agents sections state that VS Code does NOT bundle a plugin's .mcp.json or agents/ — both need adding by hand there. So for gitops-kubernetes, vibe-coding and automated-ai-engineer, a VS Code user following that sentence would have got exactly what the note warned them about: skills without the Flux MCP server or the agents. Names only Claude Code and Copilot CLI as the automatic paths and states the VS Code caveat explicitly. Found by Codex review (P2) on #71. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index c5a7044..4f74229 100644 --- a/README.md +++ b/README.md @@ -70,7 +70,7 @@ npx skills add devantler-tech/agent-plugins --skill gitops-knowledge --agent cur ``` > [!IMPORTANT] -> This is a **partial** install path. It resolves all **27 bundled skills**, but **not** the [MCP servers](#mcp-servers) or [custom agents](#custom-agents) — those are plugin-level resources that only a real plugin install delivers. For the complete plugins, use VS Code, Copilot CLI, or Claude Code above. +> This is a **partial** install path. It resolves all **27 bundled skills**, but **not** the [MCP servers](#mcp-servers) or [custom agents](#custom-agents). For those, use **Claude Code** or **Copilot CLI** above — they are the only tools that load a plugin's bundled `.mcp.json` and `agents/` automatically. In **VS Code**, a plugin install delivers the skills only, and MCP servers and agents are added manually (see [MCP servers](#mcp-servers) and [custom agents](#custom-agents) for the exact steps). ## MCP servers