diff --git a/README.md b/README.md
index 0c12eb8..dfb7af1 100644
--- a/README.md
+++ b/README.md
@@ -64,6 +64,24 @@ composer require netresearch/agent-rules-skill
 ```
 
 Requires [netresearch/composer-agent-skill-plugin](https://github.com/netresearch/composer-agent-skill-plugin).
+### npm (Node Projects)
+
+```bash
+npm install --save-dev \
+  @netresearch/agent-skill-coordinator \
+  github:netresearch/agent-rules-skill
+```
+
+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:
+
+```json
+{
+  "pnpm": {
+    "onlyBuiltDependencies": ["@netresearch/agent-skill-coordinator"]
+  }
+}
+```
+
 ## Usage
 
 The skill triggers on keywords like:
diff --git a/package.json b/package.json
new file mode 100644
index 0000000..f807287
--- /dev/null
+++ b/package.json
@@ -0,0 +1,34 @@
+{
+  "name": "@netresearch/agent-rules-skill",
+  "version": "0.0.0-source",
+  "description": "Netresearch AI skill for generating AGENTS.md, copilot-instructions.md, and other agent rule files.",
+  "license": "(MIT AND CC-BY-SA-4.0)",
+  "author": "Netresearch DTT GmbH (https://www.netresearch.de/)",
+  "homepage": "https://github.com/netresearch/agent-rules-skill",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/netresearch/agent-rules-skill.git"
+  },
+  "bugs": {
+    "url": "https://github.com/netresearch/agent-rules-skill/issues"
+  },
+  "keywords": [
+    "ai-agent-skill",
+    "agents-md",
+    "copilot-instructions",
+    "agent-rules",
+    "anthropic",
+    "claude-code"
+  ],
+  "aiAgentSkill": "skills/agent-rules/SKILL.md",
+  "files": [
+    "skills/agent-rules/",
+    "scripts/",
+    "LICENSE-MIT",
+    "LICENSE-CC-BY-SA-4.0",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "@netresearch/agent-skill-coordinator": "^0.1"
+  }
+}