@vruum/skills

@vruum/skills

Vruum AI skills for Claude Code, Codex CLI, and any AI assistant with a skill directory.

Once installed, run /vruum-guide in your harness — it takes you from an empty account to your first reviewed outreach draft, then keeps recommending the next most valuable action.

Pairs with the Vruum MCP server at https://api.vruum.ai/mcp. The MCP server exposes the skill tool (action=invoke to run a skill, action=publish to publish one), with search type=skills and fetch type=skill for discovery, so any connected client can run these skills. Skills themselves are distributed via the Claude Code plugin / marketplace; this npm package installs them into the agent-standard skills directory for harnesses without plugin support (Codex CLI, ChatGPT, Windsurf).

Install

Claude Code

Add to ~/.claude.json:

{
  "mcpServers": {
    "vruum": { "type": "http", "url": "https://api.vruum.ai/mcp" }
  }
}

Install the skills via the Claude Code plugin / marketplace (below); the MCP server provides the skill tool (action=invoke). You don't need this npm package for Claude Code.

Codex CLI

Plugin (recommended) — bundles the skills + Vruum MCP in one step:

codex plugin marketplace add vruum-gtm/skills
codex plugin add vruum@vruum-gtm
codex mcp login vruum

Manual / other harnesses — register the MCP, then install the skills into the agent-standard skills dir:

# ~/.codex/config.toml
[mcp_servers.vruum]
url = "https://api.vruum.ai/mcp"

npx @vruum/skills install                                # detects ~/.agents/skills/
npx @vruum/skills install --target /path/to/skills/dir   # any other harness

Cursor / VS Code Copilot / Cline

Register the MCP server via your editor's MCP setup (each one has its own UI / config path). Connect to https://api.vruum.ai/mcp (HTTP, OAuth via standard MCP flow). The skill tool (action=invoke) becomes available; to also install the skill files locally, use this npm package's install --target below.

Claude Desktop / Claude.ai (Cowork)

Install the Vruum plugin via the official plugin directory — bundles the connector and the skills in one step:

github.com/vruum-gtm/skills/releases/latest/download/vruum-plugin.zip

Download and upload via Settings → Customize → Plugins → "+".

ChatGPT / Windsurf / other harnesses without plugin support

npx @vruum/skills install --target /path/to/skills/dir

Coexisting with operator skills

The public and operator skill bundles can coexist in the same harness. For overlapping skill names, a valid operator-owned installation takes precedence. Public installs and uninstalls preserve the operator bundle's links and update checker. If an operator link becomes stale, the next public install restores the public skill instead of leaving a broken link.

Skills

• /campaign-builder — Build and launch an outreach campaign from criteria in about five prompts: filter contacts by size, industry, persona, region, or list; preview the cohort; create the campaign (optionally cloning messaging from an existing one); assign people; review and launch. Use when: create a campaign, build a campaign, new campaign from criteria, campaign from my list.
• /campaign-doctor — Diagnose and fix struggling outreach campaigns. Use when: fix a campaign, diagnose campaign, why is my campaign not working, campaign health, low reply rate, check campaigns, which campaigns need help.
• /create-content — Co-produce an on-voice LinkedIn content post — pull your own signal, steer the angle conversationally, draft in your voice, then save as draft, schedule, or publish. Use when: write a post, draft LinkedIn content, create content, post about, content co-production, help me write a post.
• /csv-pipeline-fill — CSV harness source for /pipeline-fill. Reads a CSV, auto-detects headers, maps columns, hands off to /pipeline-fill for harness deep research and import. Use when: import CSV, paste a CSV, csv import, prospect list from CSV, csv harness mode.
• /deal-triage — Triage your active deal pipeline. Flags at-risk deals, surfaces stalled-deal alerts, runs MEDDIC qualification, and recommends next actions. Use when: review deals, triage deals, check pipeline, deal review, morning deals, pipeline review, deal health, at-risk deals.
• /demand-gen-loop — Run the full demand-gen motion end to end from your harness — set a goal, build the audience, co-produce the creative, get explicit approval, boost the published post, then monitor engagement and bridge engagers into outreach. Hands off to the specialist skills behind a HARD approval gate. Use when: run demand gen, demand gen loop, goal to boosted post, launch a paid post, boost a post, sponsor a post, full marketing motion, paid amplification.
• /diagnose-reply — Diagnose why a reply happened — what worked or didn't in the outreach that triggered it. Use when: why did they reply, what worked, diagnose reply, reply diagnosis, analyze this reply, what caused this reply, reply analysis.
• /engagement-triage — Review and approve your pending LinkedIn engagement drafts and demand-gen content posts. Use when: triage engagements, review engagement queue, review warming comments, review nurture reactions, review marketing comments, review content drafts, check engagement queue.
• /enrich-prospect — Deep prospect diarization — synthesize everything known about a person into a structured intelligence profile. Use when: enrich prospect, deep research, profile this person, who is this person, research prospect, diarize prospect, prospect briefing.
• /expansion-fill — Source expansion-ready customers for outreach. Finds closed-won customers >60 days old with no open follow-on deal and surfaces them for an expansion play. Use when: expand customer, find upsell opportunities, NRR play, expansion opportunities, customers ripe for expansion, who can we expand to.
• /ingest-meetings — Pull meeting transcripts from your connected Google Drive into Vruum. Attaches each transcript to the right person and deal as a meeting on their timeline, and turns its action items into tasks that surface in your daily briefing. You review every attach before anything is written; safe to re-run. Use when: ingest meetings, import meeting notes, pull transcripts, log my meetings, action items from meetings, Gemini notes, Read.ai transcripts, turn meetings into tasks.
• /outreach-triage — Review and approve your pending outreach drafts across LinkedIn and email. Use when: triage, review queue, morning review, check messages, approve outreach, what needs review.
• /pipeline-fill — Source-agnostic pipeline orchestrator. Picks a source per campaign (Sales Nav / YC / CSV / account list / discovery), runs harness deep research, applies a pre-filter gate, then saves into the campaign via the backend authoritative match_score>=70 gate. Use when: fill pipeline, import prospects, daily imports, need more prospects, discover prospects from scratch, find buyers at these companies, deep research before import.
• /sales-nav-deep-fill — Sales Nav harness source for /pipeline-fill. Pre-filters Sales Nav profiles via vruum-pipeline-filter, produces a candidate list, hands off to /pipeline-fill for deep research and import. Use when: sales nav with deep research, sales nav harness mode, in-chat sales nav.
• /vruum-guide — Guide to running Vruum from your own AI harness. First run: guided onboarding from empty account to first reviewed outreach draft. After: reads live account state, recommends the single next most valuable action, hands off to the right skill. Use when: get started, onboarding, how do I use vruum, what should I do next, where do I start.
• /vruum-skills-upgrade — Upgrade @vruum/skills to the latest npm version and re-sync ~/.vruum/. Use when: upgrade vruum skills, update vruum, pull latest vruum skills, or when the preamble reports UPGRADE_AVAILABLE.
• /winback-fill — Source winback candidates from closed-lost deals or churned customers. Surfaces people who went silent or lost a deal >90 days ago, where the loss reason wasn't 'no_fit'. Use when: winback, win back churned, reactivate, revive cold deals, 90-day silent revival, lost deal recovery, lost customer outreach.
• /yc-pipeline-fill — YC harness source for /pipeline-fill. Scrapes YC's public Algolia index, extracts founder LinkedIn URLs, dedups, hands a candidate list to /pipeline-fill for deep research and import. Use when: YC pipeline fill, source from YC, fill campaign with YC founders, sales nav dried up, source YC.

Upgrade

Skills auto-prompt to upgrade via the preamble. To upgrade explicitly:

npx @vruum/skills install

Uninstall

npx @vruum/skills uninstall

Removes all symlinks this installer created. Does not touch ~/.vruum/auth.json or other co-resident tool state.

Links

• Vruum
• MCP server
• Issues