feat: ship as npm package via @netresearch/agent-skill-coordinator#28
feat: ship as npm package via @netresearch/agent-skill-coordinator#28
Conversation
Adds a package.json so the skill is npm-installable straight from this GitHub repo (no npm-registry publication required to start). README gains a parallel 'npm (Node Projects)' section under Installation, mirroring the existing 'Composer (PHP Projects)' section. Same pattern applied across the Netresearch skill collection in 2026-05. Coordinator: https://github.com/netresearch/node-agent-skill-coordinator Sibling PRs already merged on git-workflow-skill, github-project-skill, security-audit-skill. Version stays at 0.0.0-source until npm publication is decided separately. Signed-off-by: Sebastian Mendel <info@sebastianmendel.de>
There was a problem hiding this comment.
Code Review
This pull request adds npm support for the CLI tools skill by introducing a package.json file and updating the README.md with installation instructions. A review comment suggests including the catalog/ and references/ directories in the package.json files list to ensure all required tool definitions are available in the published package.
Dependency Review✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.Scanned FilesNone |
There was a problem hiding this comment.
Pull request overview
This PR makes the skill consumable from Node projects by adding npm package metadata and documenting the Node installation flow alongside the existing Composer-based installation. It fits the repository’s distribution story by exposing the existing skill bundle to the @netresearch/agent-skill-coordinator discovery mechanism.
Changes:
- Add a new
package.jsonso the repository can be installed as an npm package directly from GitHub. - Declare the skill entrypoint for Node-side discovery via the custom
aiAgentSkillmanifest field. - Extend the README with npm installation instructions, including the pnpm
postinstallallowlist note.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
package.json |
Adds npm package metadata, packaged file list, and the coordinator peer dependency. |
README.md |
Documents npm-based installation and pnpm configuration for Node consumers. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Installer scripts (skills/cli-tools/scripts/installers/*.sh and lib/catalog.sh) read tool metadata from $ROOT/catalog/*.json. Without this dir in the npm tarball, npm consumers got a partial skill that registered but failed at install time. Caught by reviewer. Signed-off-by: Sebastian Mendel <sebastian.mendel@netresearch.de>
Summary
package.jsonso the skill is npm-installable straight from this GitHub repo (no npm-registry publication required to start).How discovery works (consumer side)
After install, the coordinator's
postinstallwalksnode_modules, finds this package viaaiAgentSkill: skills/cli-tools/SKILL.md, validates the frontmatter, and writes a<skills_system>block into the project'sAGENTS.md. Same shape as the Composer plugin's output.Why version stays at
0.0.0-sourceVersioning still lives in git tags and the existing Composer release workflow. A real npm version would be set at publish time; until then,
0.0.0-sourceis the standard "this manifest exists for tooling, not as a release marker" placeholder.Sibling PRs (merged)
Coordinator: https://github.com/netresearch/node-agent-skill-coordinator (
@netresearch/agent-skill-coordinator@0.1.2)