Getting Started

How to Install Claude Skills

Everything you need to install agent skills (SKILL.md) for Claude Code, OpenAI Codex, Cursor and other compatible agents — from one-command CLI installs to remote MCP access.

1 · Three ways to install a skill

Method A — npx skills add (recommended)

The open skills CLI downloads the package from GitHub and drops it into the right directory for your agent:

$ npx skills add vercel-labs/skills

Method B — one-line ZIP install (hosted by us)

Every skill detail page has a Download ZIP button. To install from the terminal, swap <slug> for the skill slug:

$ mkdir -p ~/.claude/skills/<slug> && curl -sL https://claudeskills.club/api/skills/<slug>/download -o /tmp/s.zip && unzip -oq /tmp/s.zip -d ~/.claude/skills/<slug>

Method C — manual copy from GitHub

Create the skill folder inside your client's skills directory and copy the repo's SKILL.md (plus any scripts/ or references/ folders) into it:

$ mkdir -p ~/.claude/skills/my-skill && curl -sL https://raw.githubusercontent.com/owner/repo/main/SKILL.md -o ~/.claude/skills/my-skill/SKILL.md

2 · Where each client looks for skills

ClientGlobal (user) directoryProject directory
Claude Code~/.claude/skills/.claude/skills/
OpenAI Codex~/.agents/skills/.agents/skills/
Cursor~/.cursor/skills/ (or ~/.agents/skills/).cursor/skills/
Windsurf~/.codeium/windsurf/skills/.windsurf/skills/
Antigravity~/.agents/skills/.agents/skills/

Each skill lives in its own folder — <skills-dir>/<skill-name>/SKILL.md — so a skill called frontend-design for Claude Code lives at ~/.claude/skills/frontend-design/SKILL.md.

3 · MCP vs Agent Skills — what's the difference?

MCP servers and skills solve different problems and work best together:

Agent Skills (SKILL.md)MCP Servers
What it isA portable instruction pack — markdown (+ optional scripts) that teaches the agent how to do a taskA running server process that gives the agent live access to external systems (APIs, DBs, browsers)
Context costLoaded on demand — typically hundreds to a few thousand tokens, only when triggeredTool schemas are advertised every session; calls stream live data in and out
DistributionStatic files — copy a folder or npx skills addRequires running a process (stdio) or connecting to a remote endpoint (HTTP/SSE)
Security modelStatic text — review the markdown; check our Trust & Context card for script usageExecutable code with network access — trust depends on the server operator
Best used together when…A skill encodes when and how to call MCP tools — e.g. a "database review" skill that drives a Postgres MCP server with the right queries and checklists.

For a deeper dive into stdio vs hosted transports, see Local stdio vs Remote MCP — a practical comparison.

4 · Use our remote MCP server — search skills from inside your agent

claudeskills.club exposes a stateless Streamable HTTP MCP endpoint so your agent can search 90,000+ skills, read any SKILL.md and list curated packs — without opening a browser.

Claude Code

$ claude mcp add --transport http claudeskills https://claudeskills.club/mcp

Cursor / other clients (JSON config)

{
  "mcpServers": {
    "claudeskills": {
      "url": "https://claudeskills.club/mcp"
    }
  }
}

Once connected, your agent gets three tools: search_skills (find skills by task or keyword), get_skill_markdown (read a SKILL.md + trust summary before installing) and list_skill_packs (curated starter bundles). The endpoint is also documented in /llms-full.txt — and you can inspect it with a plain GET /mcp request.

Claude Skills MCP — verified server profile · Test it live in the Online MCP Inspector

Frequently Asked Questions

Where do I put SKILL.md so my agent picks it up?

Each client reads its own directories: Claude Code uses ~/.claude/skills (global) and .claude/skills (project), Codex uses ~/.agents/skills and .agents/skills, Cursor uses ~/.cursor/skills and .cursor/skills. Restart or start a new session after installing.

Do I need to install anything besides SKILL.md?

The SKILL.md file alone is enough for pure-markdown skills. If the package ships scripts/ or references/ folders, copy the whole skill directory so relative paths keep working — the skills CLI and our ZIP downloads handle this for you.

What's the difference between MCP and agent skills?

MCP servers are running processes that give your agent live access to external systems (APIs, databases, browsers). Skills are portable instruction packs (SKILL.md) that teach the agent how to perform a task. They're complementary — see the comparison table below.

How do I use the claudeskills.club remote MCP server?

Run `claude mcp add --transport http claudeskills https://claudeskills.club/mcp` in Claude Code, or add the JSON config shown in the Remote MCP section for Cursor and other clients. Your agent can then search 90,000+ skills, read SKILL.md files and list curated packs without leaving your editor.

Can I use the same skill in multiple clients?

Yes — SKILL.md is a vendor-neutral open format. A skill installed for Claude Code also works in Codex, Cursor, Windsurf and other compatible agents; some clients even share the ~/.agents/skills directory.