Install skills

When to use: Installing OutboundSync Agent Skills for the first time, or setting up Cursor, Claude Code, Codex, or OpenClaw to discover them. Browse every skill on the catalog.

The usual path is npx skills (vercel-labs/skills). Source of truth for the pack is GitHub outboundsync/skills; /.well-known/skills/ on this site is the same catalog as a publish mirror.

Install with npx

Recommended — one command, works for Cursor, Claude Code, Codex, and other supported harnesses:

# Full catalog from the well-known mirror (shortest)
npx skills add https://outboundsync.com

# Or install from the GitHub pack (same skills)
npx skills add outboundsync/skills -g

# One skill by name (examples)
npx skills add outboundsync/skills --skill preflight -g
npx skills add outboundsync/skills --skill crm-analysis -g
npx skills add outboundsync/skills --skill outbound-offer -g
npx skills add outboundsync/skills --skill cold-email-body -g

Copy & identity: outbound-offer, cold-email-body, cold-email-subject-lines, connection-requests, email-aliases. Deliverability: email-authentication, sending-domain-quality. Directory: agencies, integrations. Full list: Catalog of skills.

Try once without a permanent install:

npx skills use outboundsync/skills --skill preflight
npx skills use outboundsync/skills --skill outbound-offer

List what’s in the pack before installing:

npx skills add outboundsync/skills --list

Install from GitHub

Use this when you want the repo itself — clone to read, install over SSH, point at a folder, or stay close to the SoT.

# Full HTTPS URL
npx skills add https://github.com/outboundsync/skills -g

# SSH (if you already use GitHub over SSH)
npx skills add git@github.com:outboundsync/skills.git -g

# Single skill folder in the repo
npx skills add https://github.com/outboundsync/skills/tree/main/skills/preflight -g

Browse or clone the repo (no install)

git clone https://github.com/outboundsync/skills.git

Open skills/<name>/SKILL.md and the references/ beside it. Cloning alone does not register the skill with your agent — still run npx skills add when you want discovery.

Credentials

Preflight only — create a key with Creating API keys, then put it in the environment:

# .env (gitignored) — or export in your shell / CI secrets
OUTBOUNDSYNC_API_KEY=osapi_...

Agents must load $OUTBOUNDSYNC_API_KEY from the environment. Never print, log, or commit the key. Prefer a connection-scoped key when least privilege matters. API reference: API v1.

CRM analysis does not use an OutboundSync API key. It analyzes OutboundSync engagement fields already present in HubSpot or Salesforce.

Per-tool setup

After install, each harness discovers skills from the skill description metadata. You do not need a separate always-on rule that duplicates the same workflow. Hooks below are optional — install plus credentials (for preflight) is enough.

Cursor

Cursor discovers Agent Skills after npx skills add. Ask something like “am I ready to launch?” (preflight), “which campaigns got the most replies?” (CRM analysis), or “audit this cold email” (copy skills).

Optional Cursor Hooks can gate risky shell commands or automate a preflight prompt. Config lives in project .cursor/hooks.json or user ~/.cursor/hooks.json. OutboundSync does not ship a required hooks file.

Claude Code

Claude Code loads skills from .claude/skills/*/SKILL.md (Agent Skills open standard). Invoke with /skill-name when your setup supports slash skills, or ask in natural language so Claude can select the skill.

Optional Claude Code hooks live in .claude/settings.json, user settings, or skill frontmatter. Common patterns: PreToolUse to gate Bash, or SessionStart with reloadSkills after syncing a shared skills repo. Hooks are optional.

Codex

Codex reads skills from .agents/skills (cwd up to repo root) and ~/.agents/skills. Use $skill / /skills when available, or ask in natural language. Durable project guidance belongs in AGENTS.md, not in a long pasted rule that duplicates the skill.

Optional Codex hooks load from ~/.codex/hooks.json, project .codex/hooks.json, or inline [hooks] in config.toml. Non-managed hooks need trust review via /hooks in the CLI. Hooks are optional.

OpenClaw (CRM analysis)

For OpenClaw, install CRM analysis into that harness:

npx skills add outboundsync/skills --skill crm-analysis -a openclaw -g

Optional marketplace discovery (same skill, maintained in outboundsync/skills):

openclaw skills install @osiharris/crm-analysis

Catalog of skills — all 11 skills by group
Troubleshooting skills — discovery, credentials, wrong-skill picks