agent-install

Install agent skills and MCPs with one API.

Works with Claude Code, Cursor, Codex, OpenCode, and 40+ other coding agents. Writes to each one’s native config (skills directory, MCP JSON/JSONC/YAML/TOML, AGENTS.md) so your CLI or build script doesn’t have to learn ten different formats. A small agent-install CLI is also included for one-off use.

Install

As a library:

npm install agent-install

Or use the CLI directly without installing:

npx agent-install@latest --help

Quick start

npx agent-install@latest skill add owner/repo -a cursor
npx agent-install@latest mcp add https://mcp.context7.com/mcp -a cursor
npx agent-install@latest agents-md set-section "Testing" --body "Run pnpm test"

Same three actions from the Node API:

import { skill, mcp, agentsMd } from "agent-install";

await skill.add({ source: "owner/repo", agents: ["cursor"] });
mcp.add({ source: "https://mcp.context7.com/mcp", agents: ["cursor"], name: "context7" });
agentsMd.setSection({ heading: "Testing", body: "Run pnpm test" });

The Node API is namespaced by surface (skill, mcp, agentsMd) using verbs that match the CLI (add, list, remove, setSection, removeSection, read).

CLI

A thin wrapper around the Node API for one-off installs, scripts, and CI.

Skills

npx agent-install@latest skill add ./skills/react-grab
npx agent-install@latest skill add owner/repo
npx agent-install@latest skill add https://github.com/owner/repo/tree/main/skills/foo

npx agent-install@latest skill init [name]      # create a new SKILL.md
npx agent-install@latest skill list             # list installed skills
npx agent-install@latest skill remove [skills]  # remove installed skills

MCP servers

npx agent-install@latest mcp add https://mcp.context7.com/mcp -a cursor
npx agent-install@latest mcp add @modelcontextprotocol/server-postgres -a claude-code --env "DATABASE_URL=..."

npx agent-install@latest mcp list           # list installed MCP servers
npx agent-install@latest mcp remove   # remove by server name

AGENTS.md

npx agent-install@latest agents-md init
npx agent-install@latest agents-md set-section "Testing" --body "Run pnpm test"
npx agent-install@latest agents-md remove-section "Testing"
npx agent-install@latest agents-md symlink-claude
npx agent-install@latest agents-md read

Node API

You can also import each surface from its own subpath:

import * as skill from "agent-install/skill";
import * as mcp from "agent-install/mcp";