Agent Kit

Using Agent Kit

Install skills and MCP server definitions from any public GitHub repo. Agent Kit figures out the file paths, symlinks, and config merging for each agent.

Install

Run via npx or install globally

Run with npx and @latest to get the current release. You need Node.js 18 or later.

npx @levi-putna/agent-kit@latest add levi-putna/skills

Want it on your PATH? Install globally from npm:

npm install -g @levi-putna/agent-kit@latest

Socket supply chain score for @levi-putna/agent-kit

Commands

Command reference

Command	Description
list <owner/repo>	Browse skills and MCP servers available in a repo
add <owner/repo> [options]	Install skills and/or MCP servers
installed	List what is installed in the current project or globally
update	Pull the latest versions of project-installed skills from source repos
remove <name>	Remove a skill or MCP server by name

Prefix every command with npx @levi-putna/agent-kit@latest.

Skills repo

Point at any public GitHub repo

Reference a repo as owner/repo. To use a specific branch instead of main, append @branch.

npx @levi-putna/agent-kit@latest list levi-putna/skills
npx @levi-putna/agent-kit@latest add levi-putna/skills
npx @levi-putna/agent-kit@latest add levi-putna/skills@develop

Options

add command options

Skip --global and --project and Agent Kit will look for agents in your project and walk you through the rest.

Prop	Type	Default	Description
`--skill <name>`	`flag`	`-`	Install a specific skill (skips the interactive picker)
`--mcp <name>`	`flag`	`-`	Install a specific MCP server (skips the interactive picker)
`--global, -g`	`flag`	`-`	Install globally (available across all projects)
`--project, -p`	`flag`	`-`	Install to the current project
`--agent <name>`	`flag`	`-`	Target a specific agent (use with --global or --project)

# Interactive: browse and pick skills/MCP servers
npx @levi-putna/agent-kit@latest add levi-putna/skills

# Install a specific skill
npx @levi-putna/agent-kit@latest add levi-putna/skills --skill general-writing

# Install globally to Cursor only
npx @levi-putna/agent-kit@latest add levi-putna/skills --skill general-writing --global --agent cursor

# Install to the current project
npx @levi-putna/agent-kit@latest add levi-putna/skills --project

# Install from a specific branch
npx @levi-putna/agent-kit@latest add levi-putna/skills@develop --skill planning

Scope

Global vs project installs

Global

Skills land in your user directory and work across every project.

~/.claude/skills/ for Claude Code
~/.cursor/skills/ for Cursor

Project

Skills go into .agents/skills/ with symlinks from each agent directory. Agent Kit also writes agent-kit-lock.json so your team can match the setup.

npx @levi-putna/agent-kit@latest add levi-putna/skills --project
npx @levi-putna/agent-kit@latest update

MCP

MCP server installation

When installing an MCP server, Agent Kit will:

Show you the server definition and what env vars it needs
Prompt you for any required values (API keys, endpoints, etc.)
Ask permission before writing to each config file
Merge the server entry without overwriting other servers you have already configured

npx @levi-putna/agent-kit@latest add owner/repo --mcp my-server --global

Manage

Managing installed skills

npx @levi-putna/agent-kit@latest installed
npx @levi-putna/agent-kit@latest update
npx @levi-putna/agent-kit@latest remove general-writing

Publishing your own skills →