docs: document the npx skills path for agents outside the big three#71
Conversation
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.
@coderabbitai review |
Readiness record — tried and evaluated as a user Ran the documented commands against the real marketplace:
Why the "partial path" warning is in the README rather than a cheerful install line. I checked what an install actually leaves behind: skill files only. The repo bundles 1 MCP server config and 4 custom agents, and neither came through — they are plugin-level resources that only a real plugin install delivers. Documenting this as a general-purpose install path would quietly hand people a degraded Validation:
The change is prose under |
|
✅ Action performedReview finished.
|
|
Warning Review limit reached
Next review available in: 21 minutes Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available. How can I continue?After more reviews become available, a review can be triggered using the To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews. How do review limits work?CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability. For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window. Please refer docs for additional details. Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
@codex review |
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: e22989a556
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
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.
@codex review |
|
Codex Review: Didn't find any major issues. 🎉 Reviewed commit: ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
If Codex has suggestions, it will comment; otherwise it will react with 👍. Codex can also answer questions or update the PR. Try commenting "@codex address that feedback". |
Self-promoted — readiness conditions met at
Pre-merge checks are |
1 participant
Why
The install instructions covered VS Code, Copilot CLI and Claude Code. Anyone using one of the many other agents had no documented way to use any of this — even though the
npx skillspath already works against this marketplace today and reaches 70+ agents.What
Documents that path, with a clear warning that it is a partial one: it delivers the bundled skills but not the MCP server or custom agents, so people who can use a first-class tool still should. Being upfront about the limit keeps expectations right rather than sending someone to a worse experience.
Part of devantler-tech/monorepo#2229