Documentation
Everything you need to install, use, and build AI agent skills โ across any platform.
19 articles across 6 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.
๐ฌ Claude Desktop / MCP Integration
To install a TrustedSkills skill in Claude Desktop, use the MCP tab on any skill's detail page โ it shows the exact JSON config block to paste into your claude_desktop_config.json.
๐ป Quick Install Reference
openclaw skills install <slug>openclaw skills listclaude mcp add <name> -- npx -y @trustedskills/<slug>-mcp# Paste JSON config block from skill's MCP tab๐ Platform Guides
Claude Desktop
The chat app โ install skills via claude_desktop_config.json
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 MCP Skills Work Together with AI Agents: Full Guide
developerHow MCP skills work together with AI agents โ full lifecycle from finding a skill in the registry to your AI agent calling its tools, with architecture diagrams and real-world examples.
๐ฅ๏ธClaude Desktop
Install MCP Skills Claude Desktop Mac: Step-by-Step
beginnerInstall MCP skills on Claude Desktop Mac with this complete step-by-step guide. Covers config file location, Node.js setup, adding skills, and troubleshooting โ no coding experience needed.
Install MCP Skills Claude Desktop Windows: Full Guide
beginnerInstall MCP skills on Claude Desktop Windows step-by-step. Covers the config file location, JSON format, Windows path gotchas with npx, and troubleshooting tips for getting skills 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 skills to your Claude Desktop setup.
โจ๏ธClaude Code
Claude Code VS Code MCP Setup: Complete Beginner's Guide
beginnerClaude Code VS Code MCP setup guide for beginners โ install the extension, configure MCP skills in settings.json, reload to apply changes, and verify your tools are working. 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 MCP Skills Claude Code Mac: CLI & Manual Methods
developerInstall MCP skills 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 MCP Skills Claude Code Windows: CLI & Config Guide
developerInstall MCP skills for Claude Code on Windows using the CLI or manual config editing. Covers the settings.json location, Windows path formatting, and PowerShell commands to get skills working.
๐ฑ๏ธCursor / VS Code
Install MCP Skills Cursor Mac: Config Guide & Reload Tips
developerInstall MCP skills on Cursor Mac โ find the ~/.cursor/mcp.json config location, add skills in JSON format, reload Cursor to apply changes, and verify tools are working in the AI assistant.
Install MCP Skills Cursor Windows: Config & Path Guide
developerInstall MCP skills 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 skills.
๐ฆOpenClaw
Install Skills OpenClaw Mac: One-Command Setup Guide
beginnerInstall skills on OpenClaw Mac with a single command โ no JSON editing needed. OpenClaw manages MCP config automatically for all your AI agent skills. Browse, install, done.
Install Skills OpenClaw Windows: One-Command Setup
beginnerInstall skills on OpenClaw Windows with a single command โ no JSON config editing needed. Covers openclaw skills install, list, update, and remove commands with 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, skill install/update/remove commands, and Linux-specific configuration tips.
๐Advanced Topics
MCP Skills: Global vs Project Scope Across All Platforms
developerWhen to make an MCP skill 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 skill to the TrustedSkills registry. Complete guide with working code examples and publishing steps.
AI Skill Verification Trust Badges: What Each Level Means
developerAI skill verification trust badges explained โ what Unverified, Community, Verified, and Featured mean, why it matters for security against supply chain attacks, and how to get verified.
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, openai, cursor, huggingface |
metadata | JSON | Optional platform-specific config |
Need help?
Check GitHub issues or open a discussion in the community.