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: surface the Agent Skill on the landing page

Asklv12a8ff69f5f2
diff --git a/site/index.html b/site/index.html
index bba5f12..67c1abd 100644
--- a/site/index.html
+++ b/site/index.html
@@ -152,6 +152,7 @@
</div>
<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="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/socai" rel="noreferrer">Explore the socai CLI ↗</a>
</div>
</section>
diff --git a/site/llms.txt b/site/llms.txt
index ccd81fe..9606411 100644
--- a/site/llms.txt
+++ b/site/llms.txt
@@ -40,14 +40,28 @@ The HTTP server listens on `127.0.0.1`. State-changing requests require exact sa
Requirements: Node.js 20+, an OpenRouter API key with Jev access, a current socai CLI, and a Chrome session that can access the selected platform.
```bash
-npx --yes github:socai-io/jev-social onboard
-npx --yes github:socai-io/jev-social
+npx github:socai-io/jev-social#v0.1.3 onboard
+npx github:socai-io/jev-social#v0.1.3
```
Direct non-interactive example:
```bash
-OPENROUTER_API_KEY=your_key npx --yes github:socai-io/jev-social search "find emerging design creators on Instagram" --platform auto --limit 4
+npx github:socai-io/jev-social#v0.1.3 search "find emerging design creators on Instagram" --platform auto --limit 4
+```
+
+## Install as an Agent Skill
+
+GitHub CLI 2.101 or newer can install the immutable v0.1.3 skill for Codex:
+
+```bash
+gh skill install socai-io/jev-social [email protected] --agent codex --scope user
+```
+
+The cross-agent Skills CLI is also supported:
+
+```bash
+npx skills add socai-io/jev-social --skill jev-social
```
## Runtime boundaries
diff --git a/test/distribution-docs.test.js b/test/distribution-docs.test.js
new file mode 100644
index 0000000..7bb793a
--- /dev/null
+++ b/test/distribution-docs.test.js
@@ -0,0 +1,35 @@
+import assert from "node:assert/strict";
+import { readFile } from "node:fs/promises";
+import test from "node:test";
+
+const packageJson = JSON.parse(
+ await readFile(new URL("../package.json", import.meta.url), "utf8"),
+);
+const pinnedSource = `github:socai-io/jev-social#v${packageJson.version}`;
+const publicDocs = [
+ ["README.md", new URL("../README.md", import.meta.url)],
+ ["site/index.html", new URL("../site/index.html", import.meta.url)],
+ ["site/llms.txt", new URL("../site/llms.txt", import.meta.url)],
+];
+
+test("public no-clone commands require consent and pin the current release", async () => {
+ for (const [name, url] of publicDocs) {
+ const contents = await readFile(url, "utf8");
+ assert.doesNotMatch(contents, /npx\s+--yes\b/, `${name} must not auto-consent to downloads`);
+
+ const githubPackages = contents.match(/github:socai-io\/jev-social(?:#[^\s"'<`]+)?/g) ?? [];
+ assert.ok(githubPackages.length > 0, `${name} must expose a GitHub-backed command`);
+ for (const source of githubPackages) {
+ assert.equal(source, pinnedSource, `${name} must pin the current release`);
+ }
+ }
+});
+
+test("machine-readable setup avoids command-line credentials and exposes the Agent Skill", async () => {
+ const contents = await readFile(new URL("../site/llms.txt", import.meta.url), "utf8");
+ assert.doesNotMatch(contents, /OPENROUTER_API_KEY\s*=.*\bnpx\b/);
+ assert.match(
+ contents,
+ new RegExp(`gh skill install socai-io/jev-social jev-social@v${packageJson.version}\\b`),
+ );
+});