Open-source, local-first social media research agent for Instagram, TikTok, and LinkedIn. Jev routes read-only steps; socai CLI captures cited browser evidence.
JavaScript agent-skillsai-agentsbrowser-agentbrowser-automationdecision-modeldeep-researchinstagramjevlinkedinlocal-firstopen-sourceosintresearch-agentsocaisocial-listeningsocial-mediasocial-media-researchsocmintsystem-onetiktok
docs: add verified OpenClaw skill install (#52)
Asklvc5db889cd801
diff --git a/README.md b/README.mdindex 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 projenpx 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.htmlindex 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.txtindex 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 projecnpx 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 benchmarkdiff --git a/test/distribution-docs.test.js b/test/distribution-docs.test.jsindex 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),