Getting Started | ShipablesInstall the Shipables CLI and add your first AI agent skill in under two minutes.
Getting Started
This guide walks you through installing the Shipables CLI and adding a skill to your project.
Prerequisites
- Node.js 18+ — Shipables CLI requires Node.js 18 or later
- An AI coding agent — At least one of: Claude Code, Cursor, Codex CLI, VS Code / Copilot, Gemini CLI, or Cline
Install a skill
The fastest way to use Shipables is with npx — no global install needed:
npx @senso-ai/shipables install <skill-name>
For example, to install the ai-commits skill:
npx @senso-ai/shipables install Chippers255/ai-commits
The CLI will:
- Download the skill package from the registry
- Verify the integrity of the download (SHA-512)
- Auto-detect which AI agents you have installed
- Copy skill files to the agent's skills directory
- Configure any MCP servers the skill declares
If you have multiple agents installed, the CLI will ask which ones to install for. You can also specify agents explicitly:
npx @senso-ai/shipables install Chippers255/ai-commits --claude --cursor
Or install for all detected agents:
npx @senso-ai/shipables install Chippers255/ai-commits --all
Install the CLI globally (optional)
If you use Shipables frequently, install it globally for faster access:
npm install -g @senso-ai/shipables
Then use shipables directly instead of npx @senso-ai/shipables:
shipables install Chippers255/ai-commits
shipables search database
Search for skills
Find skills from the command line:
npx @senso-ai/shipables search postgres
This outputs a table of matching skills with their name, version, weekly downloads, and description.
You can filter by category or agent:
npx @senso-ai/shipables search database --category databases
npx @senso-ai/shipables search testing --agent claude
View skill details
Before installing, inspect what a skill includes:
npx @senso-ai/shipables info Chippers255/ai-commits
This shows the skill's description, author, categories, MCP servers, environment variables, and recent versions.
Install a specific version
Pin a specific version using @version syntax:
npx @senso-ai/shipables install Chippers255/ai-commits@1.0.0
Global vs project installs
By default, skills are installed at the project level — files go into your current working directory (e.g., .claude/skills/ai-commits/).
For skills you want available everywhere, use the --global flag:
npx @senso-ai/shipables install Chippers255/ai-commits --global
Global installs go to your home directory (e.g., ~/.claude/skills/ai-commits/).
Authenticate for publishing
To publish skills or manage your account, log in with GitHub:
npx @senso-ai/shipables login
This opens your browser for GitHub OAuth. Once authenticated, your token is stored in ~/.shipables/config.json.
Next steps