# agent-install > Install SKILL.md files, MCP servers, and AGENTS.md guidance for any coding agent. Ships both a Node API and a CLI. Latest version **0.0.8** (published 2026-06-24) · MIT license · 0 weekly downloads ## Install ```sh npm install agent-install pnpm add agent-install yarn add agent-install bun add agent-install ``` Provides the command `agent-install`. ## Health **Score 60/100 (C)** — status: active. Positive: has types; esm support; no vulnerabilities; high quality score. Warnings: low downloads; pre 1.0. ## Facts | | | |---|---| | Version | 0.0.8 | | Published | 2026-06-24 | | First published | 2026-05-01 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | ESM + CommonJS | | Dependencies | 6 | | Unpacked size | 334.6 KB | | Known vulnerabilities | 0 | | Install scripts | no | | Maintainers | abai | | Keywords | agent, agents-md, claude, cli, codex, cursor, install, mcp, model-context-protocol, opencode, skill, skills | ## Links - npm: https://www.npmjs.com/package/agent-install - npm.io page: https://npm.io/package/agent-install ## Dependencies (6) - [yaml](https://npm.io/package/yaml.md) ^2.8.3 - [prompts](https://npm.io/package/prompts.md) ^2.4.2 - [commander](https://npm.io/package/commander.md) ^14.0.0 - [picocolors](https://npm.io/package/picocolors.md) ^1.1.1 - [@iarna/toml](https://npm.io/package/@iarna/toml.md) ^2.2.5 - [jsonc-parser](https://npm.io/package/jsonc-parser.md) ^3.3.1 ## Alternatives - [@salesforce/cli](https://npm.io/package/@salesforce/cli.md) — 389.7K weekly downloads - [@mintlify/cli](https://npm.io/package/@mintlify/cli.md) — 208.9K weekly downloads - [@grafana/e2e-selectors](https://npm.io/package/@grafana/e2e-selectors.md) — 128.7K weekly downloads - [mintlify](https://npm.io/package/mintlify.md) — 112.0K weekly downloads - [@intlayer/cli](https://npm.io/package/@intlayer/cli.md) — 22.8K weekly downloads ## Recent versions - 0.0.8 (latest) — 2026-06-24 - 0.0.7 — 2026-06-24 - 0.0.6 — 2026-06-09 - 0.0.5 — 2026-05-01 - 0.0.4 — 2026-05-01 - 0.0.3 — 2026-05-01 - 0.0.2 — 2026-05-01 - 0.0.1 — 2026-05-01 ## README # agent-install Install `SKILL.md` files, MCP servers, and `AGENTS.md` guidance for any AI coding agent. Ships a **Node API** _and_ a **CLI** from a single package. ```bash pnpm add agent-install # or, as a one-shot CLI npx agent-install@latest ``` ## Node API ```ts import { installSkillsFromSource } from "agent-install"; import { installMcpServer } from "agent-install/mcp"; import { readAgentsMd, upsertAgentsMdSection, symlinkClaudeToAgents, } from "agent-install/agents-md"; ``` ### Skills ```ts await installSkillsFromSource({ source: "./skills/react-grab", // local, owner/repo, URL, or direct SKILL.md agents: ["claude-code", "cursor"], cwd: process.cwd(), mode: "symlink", // or "copy" }); ``` One canonical copy lives at `.agents/skills/`; agent-specific dirs (`.claude/skills`, `.cursor/skills`, etc.) receive relative symlinks, with automatic copy fallback on systems that don't allow them. ### MCP servers ```ts installMcpServer({ source: "https://mcp.context7.com/mcp", agents: ["cursor", "claude-code"], name: "context7", }); installMcpServer({ source: "@modelcontextprotocol/server-postgres", agents: ["claude-code"], env: { DATABASE_URL: "postgres://..." }, }); // Also available: // listInstalledMcpServers, removeMcpServer, parseMcpSource, // buildMcpServerConfig, mcpAgents, detectProjectInstalledMcpAgents, ... ``` 14 MCP hosts across 3 config formats (JSON/JSONC with comment preservation, YAML, TOML). Per-agent `transformConfig` hooks handle Goose's `{cmd, envs, enabled, timeout}`, Zed's `{source: "custom", ...}`, OpenCode's `{type, command[], environment}`, Codex TOML layout, and VS Code's `{type: "stdio", ...}`. Source types auto-detected by `parseMcpSource`: | Input | Type | Becomes | | --------------------------------------- | --------- | --------------------------------------- | | `https://mcp.example.com/mcp` | `remote` | `{ type: "http", url }` | | `@modelcontextprotocol/server-postgres` | `package` | `{ command: "npx", args: ["-y", pkg] }` | | `"node /path/server.js --port 3000"` | `command` | `{ command: "node", args: [...] }` | ### AGENTS.md / CLAUDE.md / GEMINI.md ```ts const { sections, content, path } = readAgentsMd(); upsertAgentsMdSection({ heading: "Testing", body: "Run `pnpm test` before every commit.", placement: "replace", // or "append" / "prepend" level: 2, }); // Agent-specific variants upsertAgentsMdSection({ agent: "gemini-cli", // writes GEMINI.md heading: "Setup", body: "...", }); // Claude Code still reads CLAUDE.md; point it at the canonical AGENTS.md await symlinkClaudeToAgents({ overwrite: false }); ``` Known variants (from `agentsMdFiles`): | Agent | File | | ----------- | --------------------- | | universal | `AGENTS.md` | | claude-code | `CLAUDE.md` | | gemini-cli | `GEMINI.md` | | cursor | `.cursor/rules/*.mdc` | | codex | `AGENTS.md` | | opencode | `AGENTS.md` | | aider | `AGENTS.md` | ## CLI ``` agent-install skill Manage SKILL.md files add -a, --agent, -s, --skill, -g, --global, --copy, -y, -l init [name] list -g, -a, --json remove [skills...] -g, -a, -y agent-install mcp add -a, -g, -t|--transport, --header, --env, -n|--name, -y, --all list -g, -a, --json remove -g, -a, -y agent-install agents-md (alias: doc) init [--agent ] read [--agent ] [-f ] [--json] set-section --body | --body-file, --placement, --level, --agent, -f remove-section --agent, -f symlink-claude --overwrite, --backup ``` ## Subpath exports | Import | Surface | | ------------------------- | --------------------------------------------------- | | `agent-install` | Skills (root default) | | `agent-install/skill` | Alias of the root import | | `agent-install/mcp` | MCP servers | | `agent-install/agents-md` | AGENTS.md manipulation + `CLAUDE.md` symlink helper | ## References - MCP build guide: [modelcontextprotocol.io/docs/develop/build-server](https://modelcontextprotocol.io/docs/develop/build-server) - AGENTS.md spec: [agents.md](https://agents.md/) --- _Source: https://npm.io/package/agent-install · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._