From e6a757603aebb41c0447bd0fb9fc04b05a1f565f Mon Sep 17 00:00:00 2001
From: Sebastian Mendel <info@sebastianmendel.de>
Date: Sat, 2 May 2026 11:24:59 +0200
Subject: [PATCH 1/2] feat: ship as npm package via
 @netresearch/agent-skill-coordinator

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>
---
 README.md    | 19 +++++++++++++++++++
 package.json | 35 +++++++++++++++++++++++++++++++++++
 2 files changed, 54 insertions(+)
 create mode 100644 package.json

diff --git a/README.md b/README.md
index 95427ba..c43bc64 100644
--- a/README.md
+++ b/README.md
@@ -45,6 +45,25 @@ composer require netresearch/context7-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/context7-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..e44ab12
--- /dev/null
+++ b/package.json
@@ -0,0 +1,35 @@
+{
+  "name": "@netresearch/context7-skill",
+  "version": "0.0.0-source",
+  "description": "Netresearch AI skill for fetching up-to-date API docs and framework patterns via Context7.",
+  "license": "(MIT AND CC-BY-SA-4.0)",
+  "author": "Netresearch DTT GmbH (https://www.netresearch.de/)",
+  "homepage": "https://github.com/netresearch/context7-skill",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/netresearch/context7-skill.git"
+  },
+  "bugs": {
+    "url": "https://github.com/netresearch/context7-skill/issues"
+  },
+  "keywords": [
+    "ai-agent-skill",
+    "context7",
+    "documentation",
+    "library-docs",
+    "api-docs",
+    "anthropic",
+    "claude-code"
+  ],
+  "aiAgentSkill": "skills/context7/SKILL.md",
+  "files": [
+    "skills/context7/",
+    "scripts/",
+    "LICENSE-MIT",
+    "LICENSE-CC-BY-SA-4.0",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "@netresearch/agent-skill-coordinator": "^0.1"
+  }
+}

From 7018fac0188fc7eee06228b3d337b53185bb1b48 Mon Sep 17 00:00:00 2001
From: Sebastian Mendel <sebastian.mendel@netresearch.de>
Date: Sat, 2 May 2026 19:16:22 +0200
Subject: [PATCH 2/2] fix(npm): drop top-level scripts/ from tarball

The skill's runtime script lives at skills/context7/scripts/context7.sh
(already covered by 'skills/context7/'). The top-level scripts/ only
holds verify-harness.sh, a repo-maintenance helper not needed by npm
consumers. Caught by reviewer.

Signed-off-by: Sebastian Mendel <sebastian.mendel@netresearch.de>
---
 package.json | 1 -
 1 file changed, 1 deletion(-)

diff --git a/package.json b/package.json
index e44ab12..911ea2f 100644
--- a/package.json
+++ b/package.json
@@ -24,7 +24,6 @@
   "aiAgentSkill": "skills/context7/SKILL.md",
   "files": [
     "skills/context7/",
-    "scripts/",
     "LICENSE-MIT",
     "LICENSE-CC-BY-SA-4.0",
     "README.md"