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: surface the Agent Skill on the landing page
Asklv12a8ff69f5f2
diff --git a/site/index.html b/site/index.htmlindex 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.txtindex 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 saRequirements: 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 boundariesdiff --git a/test/distribution-docs.test.js b/test/distribution-docs.test.jsnew file mode 100644index 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`),+ );+});