@vruum/skills 0.5.3 → 0.6.0

package/README.md

@@ -13,7 +13,7 @@ Add to `~/.claude.json`:
 ```json
 {
   "mcpServers": {
-    "vruum-local": { "type": "http", "url": "https://api.vruum.ai/mcp" }
+    "vruum": { "type": "http", "url": "https://api.vruum.ai/mcp" }
   }
 }
 ```
@@ -22,23 +22,25 @@ Slash commands appear automatically once registered. You don't need this npm pac
 
 ### Codex CLI
 
-Add to `~/.codex/config.toml`:
+**Plugin (recommended)** — bundles the skills + Vruum MCP in one step:
 
-```toml
-[mcp_servers.vruum-local]
-url = "https://api.vruum.ai/mcp"
+```bash
+codex plugin marketplace add vruum-gtm/skills
+codex plugin add vruum@vruum-gtm
+codex mcp login vruum
 ```
 
-Then run this installer to bring the skill bundle into your Codex skills directory:
+**Manual / other harnesses** — register the MCP, then install the skills into the agent-standard skills dir:
 
-```bash
-npx @vruum/skills install
+```toml
+# ~/.codex/config.toml
+[mcp_servers.vruum]
+url = "https://api.vruum.ai/mcp"
 ```
 
-Detects `~/.codex/skills/` automatically. For other harnesses without a known path:
-
 ```bash
-npx @vruum/skills install --target /path/to/skills/dir
+npx @vruum/skills install                                # detects ~/.agents/skills/
+npx @vruum/skills install --target /path/to/skills/dir   # any other harness
 ```
 
 ### Cursor / VS Code Copilot / Cline

package/install.js

@@ -78,9 +78,13 @@ function injectPrelude(skillDir) {
 
 // Known harness skill directories. Add a target here when a new harness
 // lands on a stable skill-dir convention.
+// `detect` = the harness's config dir (its presence means the harness is
+// installed); `dir` = where that harness actually reads skills from. Claude
+// Code reads ~/.claude/skills; Codex CLI (and other agents on the
+// agentskills.io standard) read ~/.agents/skills.
 const KNOWN_TARGETS = [
-  { name: 'Claude Code', dir: path.join(os.homedir(), '.claude', 'skills') },
-  { name: 'Codex CLI',   dir: path.join(os.homedir(), '.codex',  'skills') },
+  { name: 'Claude Code', detect: path.join(os.homedir(), '.claude'), dir: path.join(os.homedir(), '.claude', 'skills') },
+  { name: 'Codex CLI',   detect: path.join(os.homedir(), '.codex'),  dir: path.join(os.homedir(), '.agents', 'skills') },
 ];
 
 function parseArgs(argv) {
@@ -125,7 +129,7 @@ slash commands.
 
 Supported auto-detection:
   - Claude Code  ~/.claude/skills/
-  - Codex CLI    ~/.codex/skills/
+  - Codex CLI    ~/.agents/skills/
 
 Any other harness: pass --target <its skills directory>.
 
@@ -231,9 +235,11 @@ function linkSkill({ name, srcAbs, target, dryRun }) {
 
 function detectTargets(extraTargets) {
   const targets = [];
-  // Auto-detect only when the skills directory itself already exists.
+  // Auto-detect only when the harness's config dir exists (the skills dir may
+  // not exist yet — e.g. ~/.agents/skills for a fresh Codex user — and gets
+  // created at link time).
   for (const known of KNOWN_TARGETS) {
-    if (fs.existsSync(known.dir)) {
+    if (fs.existsSync(known.detect)) {
       targets.push({ ...known, autoDetected: true });
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vruum/skills",
-  "version": "0.5.3",
+  "version": "0.6.0",
   "description": "Vruum AI skills for Claude Code, Claude Desktop, Codex CLI, and any AI assistant with a skill directory. Slash commands for outreach triage, engagement triage, pipeline filling, prospect enrichment, and reply diagnosis. Pairs with the Vruum MCP server at https://api.vruum.ai/mcp.",
   "license": "MIT",
   "repository": {
@@ -36,5 +36,5 @@
     "outreach",
     "gtm"
   ],
-  "contentHash": "b612084d29f288715842a2c9527811f6db59778759c9cb918819f84d10ca5d30"
+  "contentHash": "5f98cbfea97d8be6ad68c50e12dca22533d20dcae067a0d5558d06e173ac1c72"
 }

package/skills/create-content/SKILL.md

@@ -6,7 +6,6 @@ description: >-
   publish. Use when: write a post, draft LinkedIn content, create content, post
   about, content co-production, help me write a post.
 ---
-
 # /create-content
 
 You co-produce a LinkedIn post in the seller's own voice. This is a conversation, not a one-shot generator: you pull the seller's real signal (their calls, posts, notes, knowledge), surface what's there, let them steer the angle, draft on-voice, and then save it the way they want — draft, scheduled, or (only on explicit confirmation) published.

package/skills/csv-pipeline-fill/SKILL.md

@@ -6,16 +6,6 @@ description: >-
   when: import CSV, paste a CSV, csv import, prospect list from CSV, csv harness
   mode.
 ---
-
-## Auto-update check
-
-Before starting, run `~/.vruum/bin/vruum-skills-update-check` (path relative to this repo). Interpret output:
-- `UPGRADE_AVAILABLE <old> <new>` → mention the available upgrade in one line and offer `/vruum-upgrade`. Then continue.
-- `JUST_UPGRADED <old> <new>` → acknowledge in one line, then continue.
-- Empty → proceed silently.
-
-Never block skill execution on this check.
-
 # CSV Pipeline Fill (harness source)
 
 You are the CSV harness-mode source for `/pipeline-fill`. You read a CSV the operator provides (Apollo export, ZoomInfo, hand-built spreadsheet, LinkedIn export — anything), normalize columns to the canonical candidate-list shape, and hand off to the orchestrator.

package/skills/deal-triage/SKILL.md

@@ -6,16 +6,6 @@ description: >-
   review deals, triage deals, check pipeline, deal review, morning deals,
   pipeline review, deal health, at-risk deals.
 ---
-
-## Auto-update check
-
-Before starting, run `~/.vruum/bin/vruum-skills-update-check` (path relative to this repo). Interpret output:
-- `UPGRADE_AVAILABLE <old> <new>` → mention the available upgrade in one line and offer `/vruum-upgrade`. Then continue.
-- `JUST_UPGRADED <old> <new>` → acknowledge in one line, then continue.
-- Empty → proceed silently.
-
-Never block skill execution on this check.
-
 # Deal Triage
 
 You are a deal pipeline orchestrator. Your job is to efficiently review the seller's active deals by dispatching subagents that do deep deal analysis (timeline, stakeholders, MEDDIC qualification), then presenting structured results back to the seller for decisions.

package/skills/diagnose-reply/SKILL.md

@@ -5,16 +5,6 @@ description: >-
   triggered it. Use when: why did they reply, what worked, diagnose reply, reply
   diagnosis, analyze this reply, what caused this reply, reply analysis.
 ---
-
-## Auto-update check
-
-Before starting, run `~/.vruum/bin/vruum-skills-update-check` (path relative to this repo). Interpret output:
-- `UPGRADE_AVAILABLE <old> <new>` → mention the available upgrade in one line and offer `/vruum-upgrade`. Then continue.
-- `JUST_UPGRADED <old> <new>` → acknowledge in one line, then continue.
-- Empty → proceed silently.
-
-Never block skill execution on this check.
-
 # /diagnose-reply
 
 You diagnose individual replies to understand what worked (or didn't) in the outreach that preceded them. This turns every reply into a learning event.

package/skills/engagement-triage/SKILL.md

@@ -6,16 +6,6 @@ description: >-
   warming comments, review nurture reactions, review marketing comments, review
   content drafts, check engagement queue.
 ---
-
-## Auto-update check
-
-Before starting, run `~/.vruum/bin/vruum-skills-update-check` (path relative to this repo). Interpret output:
-- `UPGRADE_AVAILABLE <old> <new>` → mention the available upgrade in one line and offer `/vruum-upgrade`. Then continue.
-- `JUST_UPGRADED <old> <new>` → acknowledge in one line, then continue.
-- Empty → proceed silently.
-
-Never block skill execution on this check.
-
 ## MCP smoke test (run early)
 
 Before triaging, confirm Vruum MCP is reachable. Call `get_marketing_overview` as a lightweight liveness check. On failure, surface this error and stop:

package/skills/enrich-prospect/SKILL.md

@@ -6,16 +6,6 @@ description: >-
   profile this person, who is this person, research prospect, diarize prospect,
   prospect briefing.
 ---
-
-## Auto-update check
-
-Before starting, run `~/.vruum/bin/vruum-skills-update-check` (path relative to this repo). Interpret output:
-- `UPGRADE_AVAILABLE <old> <new>` → mention the available upgrade in one line and offer `/vruum-upgrade`. Then continue.
-- `JUST_UPGRADED <old> <new>` → acknowledge in one line, then continue.
-- Empty → proceed silently.
-
-Never block skill execution on this check.
-
 # /enrich-prospect
 
 You diarize a prospect. Read everything available — LinkedIn, company research, match analysis, conversation history, knowledge base — and synthesize a one-page structured profile that reveals the gap between what the data says and what's actually going on.

package/skills/expansion-fill/SKILL.md

@@ -6,14 +6,6 @@ description: >-
   Use when: expand customer, find upsell opportunities, NRR play, expansion
   opportunities, customers ripe for expansion, who can we expand to.
 ---
-
-## Auto-update check
-
-Before starting, run `~/.vruum/bin/vruum-skills-update-check`. Interpret output:
-- `UPGRADE_AVAILABLE <old> <new>` → mention upgrade in one line, offer `/vruum-upgrade`, continue.
-- `JUST_UPGRADED <old> <new>` → acknowledge in one line, continue.
-- Empty → proceed silently.
-
 # Expansion Fill
 
 You are an expansion-side pipeline filler. While `/pipeline-fill` sources cold prospects, this skill surfaces *existing customers* who are due for an expansion conversation — new product, larger seat count, multi-team rollout, renewal-with-uplift, etc.

package/skills/outreach-triage/SKILL.md

@@ -5,16 +5,6 @@ description: >-
   when: triage, review queue, morning review, check messages, approve outreach,
   what needs review.
 ---
-
-## Auto-update check
-
-Before starting, run `~/.vruum/bin/vruum-skills-update-check` (path relative to this repo). Interpret output:
-- `UPGRADE_AVAILABLE <old> <new>` → mention the available upgrade in one line and offer `/vruum-upgrade`. Then continue.
-- `JUST_UPGRADED <old> <new>` → acknowledge in one line, then continue.
-- Empty → proceed silently.
-
-Never block skill execution on this check.
-
 # Outreach Triage
 
 You are an outreach queue orchestrator. Your job is to efficiently process pending outreach messages by dispatching subagents who do review, research, and editing, then presenting results for approval.

package/skills/pipeline-fill/RESEARCH-ENGINE.md

@@ -41,7 +41,7 @@ Before any other Step 3 work, call `get_research_playbook(segment_id=<id>)`. If
 
 > Vruum MCP not configured as a user-scoped server. Run:
 >
-> Register the Vruum MCP server in your assistant once: Claude Code → `~/.claude.json` `mcpServers.vruum-local = {"type":"http","url":"https://api.vruum.ai/mcp"}`; Codex CLI → `~/.codex/config.toml` `[mcp_servers.vruum-local]` with `url = "https://api.vruum.ai/mcp"`; other assistants → connect to `https://api.vruum.ai/mcp` (HTTP, OAuth via standard MCP flow).
+> Register the Vruum MCP server in your assistant once: Claude Code → `~/.claude.json` `mcpServers.vruum = {"type":"http","url":"https://api.vruum.ai/mcp"}`; Codex CLI → `~/.codex/config.toml` `[mcp_servers.vruum]` with `url = "https://api.vruum.ai/mcp"`; other assistants → connect to `https://api.vruum.ai/mcp` (HTTP, OAuth via standard MCP flow).
 >
 > and retry. (The cloud `claude.ai Vruum` connector doesn't propagate to subagents — they need `vruum` configured at the user scope in `~/.claude.json`.)
 

package/skills/pipeline-fill/SKILL.md

@@ -7,16 +7,6 @@ description: >-
   gate. Use when: fill pipeline, import prospects, daily imports, need more
   prospects, discover prospects from scratch, deep research before import.
 ---
-
-## Auto-update check
-
-Before starting, run `~/.vruum/bin/vruum-skills-update-check` (path relative to this repo). Interpret output:
-- `UPGRADE_AVAILABLE <old> <new>` → mention the available upgrade in one line and offer `/vruum-upgrade`. Then continue.
-- `JUST_UPGRADED <old> <new>` → acknowledge in one line, then continue.
-- Empty → proceed silently.
-
-Never block skill execution on this check.
-
 # Pipeline Fill
 
 You are a source-agnostic pipeline filler. You pick segments to fill, pick a source per segment (Sales Nav / YC / CSV / discovery), and orchestrate harness deep research that gates against the segment ICP before saving prospects into the backend pipeline.
@@ -45,8 +35,8 @@ This skill uses two subagents (defined in `.claude/agents/`):
 
 Subagents need access to the Vruum MCP server. Register it once in your AI assistant:
 
-- **Claude Code**: `~/.claude.json` → `mcpServers.vruum-local` = `{"type": "http", "url": "https://api.vruum.ai/mcp"}`
-- **Codex CLI**: `~/.codex/config.toml` → `[mcp_servers.vruum-local]` with `url = "https://api.vruum.ai/mcp"`
+- **Claude Code**: `~/.claude.json` → `mcpServers.vruum` = `{"type": "http", "url": "https://api.vruum.ai/mcp"}`
+- **Codex CLI**: `~/.codex/config.toml` → `[mcp_servers.vruum]` with `url = "https://api.vruum.ai/mcp"`
 - **Other**: connect to `https://api.vruum.ai/mcp` (HTTP, OAuth via standard MCP flow)
 
 The orchestrator's MCP precheck at the top of Step 3 (`get_research_playbook` call) catches misconfiguration upfront. Don't skip it.
@@ -141,9 +131,9 @@ Operator gives a brief like "Series A-C SaaS founders, US, 50-500 ppl" or "direc
 2. **Source companies first** — use harness tools to find candidate companies matching the brief:
    - `WebSearch` for funding announcements, news, lists ("Series A SaaS 2026", "TechCrunch Series B SaaS announcements")
    - `WebFetch` on Crunchbase / PitchBook / company directories
-   - `mcp__vruum-local__search_linkedin_people` for company-fitting roles when the brief is people-shaped (e.g. "VPs of Eng at Series A SaaS")
-3. **Source people from each company** — for each candidate company, use `mcp__vruum-local__find_people_at_company` (Unipile-backed; respects LinkedIn rate limits) to find titles matching the segment ICP. Cap at ~5 people per company to spread the discovery surface.
-4. **Dedup against existing pipeline** — for each discovered person, check `mcp__vruum-local__search_existing_people` so you don't research someone the segment already has.
+   - `mcp__vruum__search_linkedin_people` for company-fitting roles when the brief is people-shaped (e.g. "VPs of Eng at Series A SaaS")
+3. **Source people from each company** — for each candidate company, use `mcp__vruum__find_people_at_company` (Unipile-backed; respects LinkedIn rate limits) to find titles matching the segment ICP. Cap at ~5 people per company to spread the discovery surface.
+4. **Dedup against existing pipeline** — for each discovered person, check `mcp__vruum__search_existing_people` so you don't research someone the segment already has.
 5. **Show the discovered list to the operator** before handoff. Format: `Name (title) — Company [linkedin]`. Cap the surface at 2x daily_target so we don't over-source. Get a "go" / "drop X" before continuing.
 
 Discovery-path candidates produced in either path use the canonical shape in `RESEARCH-ENGINE.md` and feed into Step 3 the same way.

package/skills/sales-nav-deep-fill/SKILL.md

@@ -6,16 +6,6 @@ description: >-
   /pipeline-fill for deep research and import. Use when: sales nav with deep
   research, sales nav harness mode, in-chat sales nav.
 ---
-
-## Auto-update check
-
-Before starting, run `~/.vruum/bin/vruum-skills-update-check` (path relative to this repo). Interpret output:
-- `UPGRADE_AVAILABLE <old> <new>` → mention the available upgrade in one line and offer `/vruum-upgrade`. Then continue.
-- `JUST_UPGRADED <old> <new>` → acknowledge in one line, then continue.
-- Empty → proceed silently.
-
-Never block skill execution on this check.
-
 # Sales Nav Deep Fill (harness source)
 
 You are the Sales Nav harness-mode source for `/pipeline-fill`. You produce a candidate list from a Sales Nav saved search and hand off to the orchestrator for deep research, harness gate, and save chain.

package/skills/segment-doctor/SKILL.md

@@ -5,16 +5,6 @@ description: >-
   diagnose segment, why is my segment not working, segment health, low reply
   rate, check segments, which segments need help.
 ---
-
-## Auto-update check
-
-Before starting, run `~/.vruum/bin/vruum-skills-update-check` (path relative to this repo). Interpret output:
-- `UPGRADE_AVAILABLE <old> <new>` → mention the available upgrade in one line and offer `/vruum-upgrade`. Then continue.
-- `JUST_UPGRADED <old> <new>` → acknowledge in one line, then continue.
-- Empty → proceed silently.
-
-Never block skill execution on this check.
-
 # Segment Doctor
 
 You are a segment diagnostics and optimization agent. Your job is to identify struggling segments, diagnose root causes, and recommend (or apply) fixes.

package/skills/winback-fill/SKILL.md

@@ -7,14 +7,6 @@ description: >-
   revive cold deals, 90-day silent revival, lost deal recovery, lost customer
   outreach.
 ---
-
-## Auto-update check
-
-Before starting, run `~/.vruum/bin/vruum-skills-update-check`. Interpret output:
-- `UPGRADE_AVAILABLE <old> <new>` → mention upgrade in one line, offer `/vruum-upgrade`, continue.
-- `JUST_UPGRADED <old> <new>` → acknowledge in one line, continue.
-- Empty → proceed silently.
-
 # Winback Fill
 
 You are a winback-side pipeline filler. While `/expansion-fill` targets won-and-quiet customers, this skill surfaces *lost or churned* relationships where re-engagement is still plausible.

package/skills/yc-pipeline-fill/SKILL.md

@@ -6,16 +6,6 @@ description: >-
   /pipeline-fill for deep research and import. Use when: YC pipeline fill,
   source from YC, fill segment with YC founders, sales nav dried up, source YC.
 ---
-
-## Auto-update check
-
-Before starting, run `~/.vruum/bin/vruum-skills-update-check` (path relative to this repo). Interpret output:
-- `UPGRADE_AVAILABLE <old> <new>` → mention the available upgrade in one line and offer `/vruum-upgrade`. Then continue.
-- `JUST_UPGRADED <old> <new>` → acknowledge in one line, then continue.
-- Empty → proceed silently.
-
-Never block skill execution on this check.
-
 # YC Pipeline Fill (harness source)
 
 You are the YCombinator harness-mode source for `/pipeline-fill`. You scrape YC's public directory, extract founder LinkedIn URLs, dedup, and hand a candidate list to the orchestrator. No deep research, no harness gate, no save chain in this skill — that's all in `pipeline-fill/RESEARCH-ENGINE.md`.