Skip to content

Open-source, local-first social media research agent for Instagram, TikTok, and LinkedIn. Jev routes read-only steps; socai CLI captures cited browser evidence.

docs: add verified OpenClaw skill install (#52)

Asklvc5db889cd801
diff --git a/README.md b/README.md
index 999dcbc..852e13a 100644
--- a/README.md
+++ b/README.md
@@ -112,6 +112,12 @@ For OpenCode, install the tested v0.1.8 skill into its natively discovered proje
npx skills add https://github.com/socai-io/jev-social/tree/v0.1.8/skills/jev-social --agent opencode
```
+For OpenClaw, install the v0.1.8 skill from its immutable release commit into the current workspace:
+
+```bash
+npx skills add https://github.com/socai-io/jev-social/tree/c411ae1532dd37ab94f8164f13552ed05f4c9ecc/skills/jev-social --skill jev-social --agent openclaw --copy
+```
+
The skill pins the documented Jev Social CLI release, preserves its read-only and login-gate boundaries, and returns source-linked evidence instead of raw run JSON. Platform availability is checked against the installed socai CLI before a run.
To work from a source checkout instead:
diff --git a/site/index.html b/site/index.html
index 1e11d6f..b1ecbb5 100644
--- a/site/index.html
+++ b/site/index.html
@@ -214,7 +214,7 @@
<div class="run-actions">
<a class="button button-pink" href="https://github.com/socai-io/jev-social" rel="noreferrer">Star Jev Social ★</a>
<a class="text-link" href="./local-system-one/">Run with local Kev ↗</a>
- <a class="text-link" href="https://github.com/socai-io/jev-social#run-it" rel="noreferrer">Install the Agent Skill ↗</a>
+ <a class="text-link" href="https://github.com/socai-io/jev-social#run-it" rel="noreferrer">Install for Codex, OpenCode, or OpenClaw ↗</a>
<a class="text-link" href="https://github.com/socai-io/socai" rel="noreferrer">Explore the socai CLI ↗</a>
</div>
</section>
diff --git a/site/llms.txt b/site/llms.txt
index fa264d6..1cb34a2 100644
--- a/site/llms.txt
+++ b/site/llms.txt
@@ -76,7 +76,13 @@ OpenCode can install the tested v0.1.8 Skill into its natively discovered projec
npx skills add https://github.com/socai-io/jev-social/tree/v0.1.8/skills/jev-social --agent opencode
```
-This is a standard Agent Skill that calls the local socai CLI, not an OpenCode plugin.
+OpenClaw can install the v0.1.8 Skill from its immutable release commit into the current workspace:
+
+```bash
+npx skills add https://github.com/socai-io/jev-social/tree/c411ae1532dd37ab94f8164f13552ed05f4c9ecc/skills/jev-social --skill jev-social --agent openclaw --copy
+```
+
+This is a standard Agent Skill that calls the local socai CLI, not an OpenCode or OpenClaw plugin.
## Reproducible benchmark
diff --git a/test/distribution-docs.test.js b/test/distribution-docs.test.js
index 39c267f..e0883ae 100644
--- a/test/distribution-docs.test.js
+++ b/test/distribution-docs.test.js
@@ -9,6 +9,12 @@ const packageJson = JSON.parse(
const releaseTag = `v${packageJson.version}`;
const pinnedSource = `github:socai-io/jev-social#v${packageJson.version}`;
const pinnedSkillSource = `https://github.com/socai-io/jev-social/tree/v${packageJson.version}/skills/jev-social`;
+const releaseCommit = execFileSync(
+ "git",
+ ["rev-parse", `${releaseTag}^{commit}`],
+ { cwd: new URL("..", import.meta.url), encoding: "utf8" },
+).trim();
+const pinnedOpenClawSkillSource = `https://github.com/socai-io/jev-social/tree/${releaseCommit}/skills/jev-social`;
const kevRepoCommit = "2855ba2a55a80579176a459f78b95d03548cabb5";
const kevModelRevision = "139fdd94f1b6a6ad80cc15e08fcb99cac885a101";
const pinnedKevCommands = [
@@ -83,7 +89,7 @@ test("machine-readable setup avoids command-line credentials and exposes the Age
);
});
-test("cross-agent Skill installers use the tagged release", async () => {
+test("cross-agent Skill installers use an immutable release source", async () => {
for (const [name, url] of publicDocs) {
const contents = await readFile(url, "utf8");
assert.doesNotMatch(
@@ -92,11 +98,28 @@ test("cross-agent Skill installers use the tagged release", async () => {
`${name} must not install the mutable default branch`,
);
for (const command of contents.match(/npx skills add [^\n<`]*/g) ?? []) {
- assert.match(command, new RegExp(pinnedSkillSource.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")));
+ assert.ok(
+ command.includes(pinnedSkillSource) || command.includes(pinnedOpenClawSkillSource),
+ `${name} must pin the release tag or its exact commit`,
+ );
}
}
});
+test("OpenClaw setup uses the verified immutable release Skill command", async () => {
+ const expected = `npx skills add ${pinnedOpenClawSkillSource} --skill jev-social --agent openclaw --copy`;
+ const [readme, llms, landing] = await Promise.all([
+ readFile(new URL("../README.md", import.meta.url), "utf8"),
+ readFile(new URL("../site/llms.txt", import.meta.url), "utf8"),
+ readFile(new URL("../site/index.html", import.meta.url), "utf8"),
+ ]);
+
+ assert.match(readme, new RegExp(expected.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")));
+ assert.match(llms, new RegExp(expected.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")));
+ assert.match(llms, /standard Agent Skill[\s\S]*not an OpenCode or OpenClaw plugin/i);
+ assert.match(landing, /Codex, OpenCode, or OpenClaw/);
+});
+
test("package, plugin manifests, and Agent Skill identify the current release", async () => {
const [codexManifest, grokManifest, skill] = await Promise.all([
readFile(new URL("../.codex-plugin/plugin.json", import.meta.url), "utf8").then(JSON.parse),