feat: ship as npm package via @netresearch/agent-skill-coordinator#37
feat: ship as npm package via @netresearch/agent-skill-coordinator#37
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>
Dependency Review✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.Scanned FilesNone |
There was a problem hiding this comment.
Code Review
This pull request introduces npm support for the Matrix skill by adding installation instructions to the README and creating a package.json for distribution. Feedback indicates that the .claude-plugin/ directory should be included in the files array to ensure the manifest is packaged, and the aiAgentSkill field should be converted to an array to correctly register both the communication and administration skills.
There was a problem hiding this comment.
Pull request overview
This PR adds npm-installation metadata for the Matrix skill repository so Node-based projects can consume it through @netresearch/agent-skill-coordinator, alongside the existing Composer-based distribution path. It extends the repo’s packaging/discovery story rather than changing the Matrix skill implementations themselves.
Changes:
- Add a root
package.jsonthat makes the repo installable as@netresearch/matrix-skillfrom GitHub. - Declare npm-side skill discovery metadata and packaged file list for the coordinator workflow.
- Document the Node/npm installation path in
README.md, including pnpm postinstall allowlisting.
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 selection, and coordinator peer dependency for GitHub-based installs. |
README.md |
Documents npm installation and pnpm setup for coordinator-based skill registration. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
The repo ships both skills/matrix-communication/SKILL.md and skills/matrix-administration/SKILL.md, but only the former was listed in composer.json's extra.ai-agent-skill (and inherited by the new package.json's aiAgentSkill). Switch both fields to JSON arrays so the coordinator discovers both skills. Signed-off-by: Sebastian Mendel <info@sebastianmendel.de>
|
Updated composer.json + package.json so aiAgentSkill is an array of both bundled skills (matrix-communication + matrix-administration). Single-string declaration was missing matrix-administration. |
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/matrix-communication/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)