Documentation
Everything you need to install, use, and build AI agent skills — across any platform.
23 articles across 7 categories
New here? Start with the concepts
Before installing anything, these three short articles will give you the full picture of how MCP, skills, and npx fit together.
Skills vs MCP servers
Most skills on TrustedSkills are SKILL.md skills. Install one with the npx skills add command on its page. It needs no JSON config.
An MCP server is different. You add it to your client's config file, such as claude_desktop_config.json. Copy the block from the server's own README. For example:
Quick Install Reference
npx skills add <owner>/<repo> --skill <name>npx skills add <owner>/<repo> --skill <name> -a claude-codenpx skills add <owner>/<repo> --skill <name> -gnpx skills listPlatform Guides
Claude Code
The coding assistant — global and project-level MCP config
Foundational Concepts
MCP vs Skills vs Plugins AI: What's the Difference?
beginnerUnderstand MCP vs skills vs plugins AI terminology once and for all. Clear definitions, a side-by-side comparison table, and practical guidance on when to use each term.
What is npx MCP Server? Why Every MCP Config Uses It
beginnerWhat is npx MCP server — explained simply. Learn why every MCP config uses npx -y, what the flag does, and when to use npx vs a global npm install for your AI skills.
How Skills and MCP Servers Work Together in AI Agents
developerHow skills and MCP servers work together in AI agents — the full lifecycle from finding an MCP server to your AI agent calling its tools, with architecture diagrams and real-world examples.
Claude Desktop
Install a TrustedSkills Skill in Claude Desktop
beginnerThe skills CLI has no Claude Desktop target. Here is what does work: paste a skill into a conversation with npx skills use, or install it into Claude Code on the same machine.
Install an MCP Server in Claude Desktop on Mac: Step-by-Step
beginnerInstall an MCP server on Claude Desktop Mac with this complete step-by-step guide. Covers config file location, Node.js setup, adding a server, and troubleshooting — no coding experience needed.
Install an MCP Server in Claude Desktop on Windows: Full Guide
beginnerInstall an MCP server on Claude Desktop Windows step-by-step. Covers the config file location, JSON format, Windows path gotchas with npx, and troubleshooting tips for getting a server working.
Install MCP Claude Desktop Linux: Config & Setup Guide
developerInstall MCP on Claude Desktop Linux — config file path at ~/.config/Claude/, NVM workarounds, and Linux-specific tips for successfully adding MCP servers to your Claude Desktop setup.
Claude Code
Install a TrustedSkills Skill in Claude Code
beginnerInstall a SKILL.md skill from TrustedSkills into Claude Code with one skills CLI command. Covers project vs global scope, where the files land, how to confirm it loaded, and how to remove it.
Claude Code VS Code MCP Setup: Complete Beginner's Guide
beginnerClaude Code VS Code MCP setup guide for beginners — install the extension, add MCP servers with claude mcp add, find them in ~/.claude.json or .mcp.json, and check them with /mcp. No experience needed.
Claude Code MCP Global vs Project Config: When to Use Each
developerClaude Code MCP global project config explained — when to use global vs project-level settings, how to safely share skills with your team via git, and how to handle secrets across environments.
Install an MCP Server in Claude Code on Mac: CLI & Manual Methods
developerInstall an MCP server for Claude Code on Mac using the CLI or manual config editing. Covers global vs project scope, NVM path fixes, and how to verify tools are loading correctly.
Install an MCP Server in Claude Code on Windows: CLI & Config Guide
developerInstall an MCP server for Claude Code on Windows using the CLI or manual config editing. Covers where Claude Code stores MCP servers (~/.claude.json and .mcp.json), Windows path formatting, and PowerShell commands.
Cursor / VS Code
Install a TrustedSkills Skill in Cursor
beginnerInstall a SKILL.md skill from TrustedSkills into Cursor with one skills CLI command. Covers the .agents/skills folder Cursor loads from, project vs global scope, verification, and removal.
Install an MCP Server in Cursor on Mac: Config Guide & Reload Tips
developerInstall an MCP server on Cursor Mac — find the ~/.cursor/mcp.json config location, add a server in JSON format, reload Cursor to apply changes, and verify tools are working in the AI assistant.
Install an MCP Server in Cursor on Windows: Config & Path Guide
developerInstall an MCP server for Cursor on Windows — config file location at %USERPROFILE%\.cursor\mcp.json, JSON format, Windows path gotchas with npx, and how to reload and verify a server.
OpenClaw
Install Skills OpenClaw Mac: One-Command Setup Guide
beginnerInstall skills on OpenClaw Mac with a single command — no JSON editing needed. Covers the skills CLI for TrustedSkills listings, openclaw skills commands for ClawHub, and where skills are stored.
Install Skills OpenClaw Windows: One-Command Setup
beginnerInstall skills on OpenClaw Windows with a single command — no JSON config editing needed. Covers the skills CLI, openclaw skills install, list and update, how to remove a skill, and Windows-specific notes.
Install Skills OpenClaw Linux: Quick Setup Guide
beginnerInstall skills on OpenClaw Linux with one command — no JSON editing needed. Covers Node.js setup via nvm, the skills CLI and openclaw skills commands, and where skills are stored.
Advanced Topics
MCP Servers: Global vs Project Scope Across All Platforms
developerWhen to make an MCP server available to all projects vs one project — decision framework, config paths for every platform, team collaboration workflow, and how to handle secrets safely.
How to Build an AI Agent Skill: Beginner's Complete Guide
advancedHow to build an AI agent skill from scratch — create, test and publish your first MCP server, then submit it to TrustedSkills. Complete guide with working code examples and publishing steps.
What Each TrustedSkills Badge Actually Means
developerThe TrustedSkills badges explained honestly: Official, Featured, Pinned, Listed and Unverified describe provenance, not a security audit. Plus a checklist for vetting a skill yourself.
The Automated Safety Pass: What "Checked" Actually Means
developerExactly what the TrustedSkills automated safety scan looks for in every skill — credential access, undeclared network calls, obfuscated payloads, pipe-to-shell installers — how it decides, and what it cannot tell you.
SKILL.md Required Fields
| Field | Type | Description |
|---|---|---|
name | string | Unique slug identifier (lowercase, hyphens only) |
description | string | One-line description (10-500 characters) |
version | semver | Semantic version (e.g. 1.0.0) |
platforms | array | Supported platforms: openclaw, mcp, claude, claudecode, openai, cursor, codex, opencode |
metadata | JSON | Optional platform-specific config |
Need help?
Open an issue on GitHub — a wrong command in these docs, a bad listing, or a skill behaving badly. We read every report and can delist a skill from the index. We don't promise a response time.