Skip to content

Commit 01971d3

Browse files
authored
feat: ship as npm package via @netresearch/agent-skill-coordinator (#37)
## Summary - Adds `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. ## How discovery works (consumer side) ```bash npm install --save-dev \ @netresearch/agent-skill-coordinator \ github:netresearch/matrix-skill ``` After install, the coordinator's `postinstall` walks `node_modules`, finds this package via `aiAgentSkill: skills/matrix-communication/SKILL.md`, validates the frontmatter, and writes a `<skills_system>` block into the project's `AGENTS.md`. Same shape as the Composer plugin's output. ## Why version stays at `0.0.0-source` Versioning 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-source` is the standard "this manifest exists for tooling, not as a release marker" placeholder. ## Sibling PRs (merged) - netresearch/git-workflow-skill#39 - netresearch/github-project-skill#67 - netresearch/security-audit-skill#67 Coordinator: https://github.com/netresearch/node-agent-skill-coordinator (`@netresearch/agent-skill-coordinator@0.1.2`)
2 parents 034aec1 + f4601b3 commit 01971d3

3 files changed

Lines changed: 62 additions & 1 deletion

File tree

README.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -67,6 +67,24 @@ composer require netresearch/matrix-skill
6767
```
6868

6969
Requires [netresearch/composer-agent-skill-plugin](https://github.com/netresearch/composer-agent-skill-plugin).
70+
### npm (Node Projects)
71+
72+
```bash
73+
npm install --save-dev \
74+
@netresearch/agent-skill-coordinator \
75+
github:netresearch/matrix-skill
76+
```
77+
78+
Requires [@netresearch/agent-skill-coordinator](https://github.com/netresearch/node-agent-skill-coordinator), which discovers the skill in `node_modules` and registers it in `AGENTS.md` via a `postinstall` hook. For pnpm, also allowlist the coordinator's postinstall:
79+
80+
```json
81+
{
82+
"pnpm": {
83+
"onlyBuiltDependencies": ["@netresearch/agent-skill-coordinator"]
84+
}
85+
}
86+
```
87+
7088
## Prerequisites
7189

7290
**For E2EE support** (most Matrix rooms), install libolm:

composer.json

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,10 @@
1717
"netresearch/composer-agent-skill-plugin": "*"
1818
},
1919
"extra": {
20-
"ai-agent-skill": "skills/matrix-communication/SKILL.md"
20+
"ai-agent-skill": [
21+
"skills/matrix-communication/SKILL.md",
22+
"skills/matrix-administration/SKILL.md"
23+
]
2124
},
2225
"support": {
2326
"issues": "https://github.com/netresearch/matrix-skill/issues",

package.json

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
{
2+
"name": "@netresearch/matrix-skill",
3+
"version": "0.0.0-source",
4+
"description": "Netresearch AI skill for Matrix chat communication and homeserver administration.",
5+
"license": "(MIT AND CC-BY-SA-4.0)",
6+
"author": "Netresearch DTT GmbH (https://www.netresearch.de/)",
7+
"homepage": "https://github.com/netresearch/matrix-skill",
8+
"repository": {
9+
"type": "git",
10+
"url": "git+https://github.com/netresearch/matrix-skill.git"
11+
},
12+
"bugs": {
13+
"url": "https://github.com/netresearch/matrix-skill/issues"
14+
},
15+
"keywords": [
16+
"ai-agent-skill",
17+
"matrix",
18+
"chat",
19+
"synapse",
20+
"e2ee",
21+
"anthropic",
22+
"claude-code"
23+
],
24+
"aiAgentSkill": [
25+
"skills/matrix-communication/SKILL.md",
26+
"skills/matrix-administration/SKILL.md"
27+
],
28+
"files": [
29+
".claude-plugin/",
30+
"skills/matrix-communication/",
31+
"skills/matrix-administration/",
32+
"scripts/",
33+
"LICENSE-MIT",
34+
"LICENSE-CC-BY-SA-4.0",
35+
"README.md"
36+
],
37+
"peerDependencies": {
38+
"@netresearch/agent-skill-coordinator": "^0.1"
39+
}
40+
}

0 commit comments

Comments
 (0)