docs: clarify agentplugins quick start - #48
Conversation
|
Warning Review limit reached
Next review available in: 56 minutes You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository. 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. 📝 WalkthroughWalkthroughThe README files update plugin source and authoring guidance, replace the Quick Start command, require Node.js 22 or newer, and document release 0.1.5 bootstrap validation across supported platforms. ChangesDocumentation updates
Estimated code review effort: 2 (Simple) | ~10 minutes Possibly related PRs
Poem
🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✨ Finishing Touches🧪 Generate unit tests (beta)
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 |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@README.md`:
- Around line 134-138: Update the root README Quick Start setup before the npx
universal-agent-plugins examples to state the Node.js 22+ prerequisite, while
preserving the existing command examples and other runtime requirements.
🪄 Autofix
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Organization UI
Review profile: CHILL
Plan: Pro Plus
Run ID: bb42c6b2-e314-4fdd-ade7-ece1d5bdf2c6
📒 Files selected for processing (2)
README.mdnpm/agentplugins/README.md
| Want to try a real Agent Plugin without installing a CLI permanently? | ||
|
|
||
| ```bash | ||
| npx plugin-kit-ai@latest add notion | ||
| npx universal-agent-plugins add context7 | ||
| ``` |
There was a problem hiding this comment.
🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win
🧩 Analysis chain
🏁 Script executed:
#!/bin/bash
set -euo pipefail
rg -n -C 3 'Node\.js|Node |node|Prerequisite|universal-agent-plugins' README.mdRepository: 777genius/plugin-kit-ai
Length of output: 2659
🏁 Script executed:
#!/bin/bash
set -euo pipefail
echo '--- repo package manifests ---'
git ls-files | grep -E '(^|/)package\.json$' | sed -n '1,120p'
echo '--- universal-agent-plugins package ---'
for f in $(git ls-files | grep -E 'npm/.*/package\.json$|agentplugins/package\.json$|package\.json$'); do
grep -l 'universal-agent-plugins\|agentplugins' "$f" || true
done
echo '--- package.json snippets ---'
fd -a 'package\.json$' . | while read -r f; do
rel="${f#"$PWD"/}"
echo "### $rel"
python3 - <<'PY' "$rel"
import json, sys
path=sys.argv[1]
try:
data=json.load(open(path))
except Exception as e:
print(f"error: {e}")
raise SystemExit
print({"name": data.get("name"), "version": data.get("version"), "type": data.get("type"), "engines": data.get("engines"), "scripts": list(data.get("scripts", {}).keys())})
PY
doneRepository: 777genius/plugin-kit-ai
Length of output: 3142
🌐 Web query:
npm universal-agent-plugins node >=22 README
💡 Result:
There is no single, official npm package exclusively named universal-agent-plugins that functions as a standalone standard library. Instead, the term refers to a ecosystem of tools and repositories related to the Agent Plugins standard [1][2][3]. Regarding Node.js version requirements: The repository maintained by 777genius (which uses the universal-agent-plugins catalog) specifies that its upstream components require Node.js versions ^20.19.0, ^22.12.0, or >=23 [4]. This confirms that Node.js 22 is supported, specifically at version 22.12.0 or higher [4]. Key Context: 1. Standard Definition: Agent Plugins is an open, vendor-neutral standard for packaging AI agent components (including skills and MCP servers) [3]. It is managed via repositories like the Agent Plugins specification [3] and various implementation tools [2][5]. 2. Installation: While some tools allow installation via npm (e.g., npx), it is frequently recommended to use modern, cross-platform installers like uvx or native CLI tools provided by specific agent frameworks to avoid common issues with symlinks or environment management, particularly on Windows [6][5]. 3. Repository Confusion: Several repositories use similar naming conventions (e.g., 777genius/universal-plugins-for-ai-agents, richfrem/agent-plugins-skills). Users are advised to consult the official documentation for the specific AI agent harness they are using (e.g., Claude Code, Cursor) to identify the correct plugin catalog [7][5][8]. If you are following a specific tutorial, ensure you are referencing the documentation associated with that specific repository, as installation methods and requirements may vary [5][8].
Citations:
- 1: https://agentplugins.pages.dev/
- 2: https://github.com/sigilco/agentplugins
- 3: https://agent-plugins.org/
- 4: https://github.com/777genius/universal-plugins-for-ai-agents/tree/main/plugins/chrome-devtools/plugin
- 5: https://github.com/richfrem/agent-plugins-skills
- 6: https://github.com/richfrem/agent-plugins-skills/blob/main/INSTALL.md
- 7: https://github.com/777genius/universal-plugins-for-ai-agents
- 8: https://github.com/rohan-tessl/agent-plugins-skills
🏁 Script executed:
#!/bin/bash
set -euo pipefail
echo '--- README Node/Prerequisite evidence ---'
sed -n '1,220p' README.md | nl -ba | sed -n '1,220p' | grep -n -E 'Node|node|Prerequisite|prerequisite|requirements|requirement|install|install node|npx universal-agent-plugins' -C 3 || true
echo '--- npm/agentplugins README Node evidence ---'
sed -n '1,200p' npm/agentplugins/README.md | nl -ba | sed -n '1,200p' | grep -n -E 'Node|node|Prerequisite|prerequisite|requirements|requirement|install node|npx universal-agent-plugins' -C 3 || trueRepository: 777genius/plugin-kit-ai
Length of output: 321
Add the Node.js prerequisite before the npx command.
universal-agent-plugins declares engines.node >=22, but the root README only mentions Node.js requirements for runtime/non-Go paths. Add Node.js 22+ to the root Quick Start setup before the npx universal-agent-plugins add context7 examples so users on Node 20 or older do not run an unsupported command path.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@README.md` around lines 134 - 138, Update the root README Quick Start setup
before the npx universal-agent-plugins examples to state the Node.js 22+
prerequisite, while preserving the existing command examples and other runtime
requirements.
1 participant
Makes the standard-first Agent Plugins CLI the default user quick start. Adds the Node.js 22 prerequisite and the exact supported platform matrix proven by the 0.1.5 release, while keeping legacy plugin-kit-ai authoring clearly separate.\n\nValidation: npm tests 26/26, README contracts, and diff check.
Summary by CodeRabbit