From mcp-skills
Generates documented, searchable skill files for MCP servers: import from settings, auto-discover tools, organize with INDEX.md, examples, and fixes.
How this skill is triggered — by the user, by Claude, or both
Slash command
/mcp-skills:mcp-skillsThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Transform your MCP servers into well-documented, searchable skills. Import from global settings, auto-discover tools, and keep everything organized.
Transform your MCP servers into well-documented, searchable skills. Import from global settings, auto-discover tools, and keep everything organized.
MCP servers are powerful but:
MCP Skills fixes this by creating a searchable skill file for each MCP with:
# 1. Install recommended MCPs (context7, sequential-thinking, memory, fetch)
./scripts/install-starter-mcps.sh
# 2. Restart Claude Code to activate MCPs
# 3. Initialize skills directory with pre-written docs
./scripts/init-skills.sh
# 4. Import any additional MCPs from your settings
./scripts/import-mcps.sh
New to MCPs? The starter pack installs 4 essential MCPs:
| MCP | What It Does |
|---|---|
| context7 | Fetch up-to-date library docs (avoids hallucinated APIs) |
| sequential-thinking | Step-by-step reasoning with revision & branching |
| memory | Persistent memory across sessions (local knowledge graph) |
| fetch | Read web pages and convert to markdown |
./scripts/install-starter-mcps.sh
Pre-written documentation included in templates/ folder!
| Command | What It Does |
|---|---|
/mcp-skills | Browse and search your MCP skills |
/mcp-skills --import | Import MCPs from global settings |
/mcp-skills --sync | Rebuild the INDEX.md |
/mcp-skills --discover <name> | Auto-discover tools for an MCP |
mcp-skills/
├── INDEX.md # Searchable directory of all skills
├── _template.md # Template for new skills
├── github.md # Auto-imported skill
├── memory.md # Auto-imported skill
├── filesystem.md # Auto-imported skill
└── ...
Each skill has:
---
skill_id: github
mcp_server: github
category: development
tags: [git, repos, issues]
---
# GitHub MCP Skill
## Purpose
Interact with GitHub repos, issues, PRs...
## Tools Available
### search_repositories
Search for repos by query.
**Arguments:**
{
"query": "string - search query",
"per_page": "number - results per page (default 30)"
}
**Example:**
Use MCP tool github:search_repositories with {"query": "claude code"}
# See what would be imported (no changes)
./scripts/import-mcps.sh --dry-run
# Import with backup of global settings
./scripts/import-mcps.sh --backup
# Standard import
./scripts/import-mcps.sh
Copy the template:
cp mcp-skills/_template.md mcp-skills/my-mcp.md
Fill in:
skill_id - unique identifiermcp_server - matches your MCP configcategory - for organizationSync the index:
./scripts/sync-index.sh
Organize skills by type:
| Category | For |
|---|---|
development | GitHub, GitLab, CI/CD |
data | Databases, APIs |
communication | Slack, Discord, email |
infrastructure | AWS, Docker, K8s |
imported | Auto-imported (update these!) |
custom | Project-specific |
Don't know what tools an MCP has? Ask Claude:
What tools are available in the github MCP server?
List all tools with their arguments.
Then document them in the skill file!
Your ~/.claude/settings.json has no mcpServers configured.
Install jq: brew install jq (macOS) or apt install jq (Linux)
Run ./scripts/sync-index.sh to rebuild.
Works great with:
npx claudepluginhub lego4005/foxit-marketplace --plugin mcp-skillsDiscovers and loads MCP skills for building TypeScript/Python servers, designing tools/resources/prompts, implementing JSON-RPC/transports, and testing/debugging integrations.
Manages MCP servers by discovering, analyzing, and executing tools/prompts/resources via CLI scripts. Use for integrations, capability discovery, tool filtering, and context bloat resolution.
Handles Claude Code MCP integration: installs/manages servers (HTTP/SSE/stdio), scopes, enterprise configs, OAuth auth, resources/@mentions, prompts, limits, security; delegates to docs-management.