skills-mcp-server

sfc-gh-dflippo/skills-mcp-server

3.1

If you are the rightful owner of skills-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Skills MCP Server is designed to manage AI agent skills from GitHub repositories using a Model Context Protocol (MCP) server, providing downloadable sync scripts.

Skills Sync Skill

Note: This repository previously contained an MCP server that distributed sync scripts as resources. The MCP server has been replaced by a self-contained skill that provides the same sync scripts directly.

This repository contains the skills-sync skill for managing AI agent skills from local SKILL.md files and remote Git repositories.

What is the Skills Sync Skill?

The skills-sync skill provides tools and guidance for syncing AI agent skills from both local SKILL.md files and remote Git repositories into a consolidated AGENTS.md catalog. It includes:

  • Python sync script (sync-skills.py) - Standalone, auto-installs dependencies
  • TypeScript sync script (sync-skills.ts) - Zero external dependencies
  • Comprehensive documentation - Usage guide, troubleshooting, and best practices

Installation

Copy the skill folder to your project:

# Clone this repository
git clone https://github.com/sfc-gh-dflippo/skills-mcp-server.git

# Copy the skill to your project's .claude/skills/ directory
cp -r skills-mcp-server/.claude/skills/skills-sync /path/to/your/project/.claude/skills/

Or add this repository to your .claude/skills/repos.txt:

https://github.com/sfc-gh-dflippo/skills-mcp-server

Then run any existing sync script to pull it in.

Usage

Quick Start

  1. Ensure .claude/skills/repos.txt exists in your project root with repository URLs:
https://github.com/anthropics/skills
https://github.com/your-org/your-skills-repo
  1. Run the sync script (automatically finds project root):
# Python version
python3 .claude/skills/skills-sync/scripts/sync-skills.py

# OR TypeScript version
npx tsx .claude/skills/skills-sync/scripts/sync-skills.ts
  1. Check AGENTS.md for updated skills catalog

How It Works

The scripts:

  1. Clone/pull repositories to .claude/skills/repositories/ (shallow clones for efficiency)
  2. Scan entire project for SKILL.md files (excluding node_modules, .git, venv, pycache)
  3. Parse YAML frontmatter (name and description fields)
  4. Apply precedence: local skills override repository skills
  5. Update AGENTS.md between markers with organized catalog

Key Features

  • Automatic Project Root Detection - Scripts walk up directory tree to find project root
  • No Copying Required - Scripts run directly from their location
  • Local Skill Precedence - Local SKILL.md files override repository skills
  • Multiple Language Support - Python and TypeScript implementations
  • Zero Configuration - Works out of the box with sensible defaults

Repository Structure

skills-mcp-server/
├── .claude/
│   └── skills/
│       ├── skills-sync/          # The skill
│       │   ├── SKILL.md          # Complete usage guide
│       │   └── scripts/
│       │       ├── sync-skills.py
│       │       └── sync-skills.ts
│       └── repos.txt             # Repository configuration
└── AGENTS.md                     # Generated skills catalog

Requirements

Python Script:

  • Python 3.8+
  • Auto-installs python-frontmatter if needed

TypeScript Script:

  • Node.js 18+
  • Zero external dependencies (uses Node built-ins)

Both scripts require Git to be installed.

Documentation

Full documentation is available in the skill's SKILL.md file:

  • Configuration - Setting up .claude/skills/repos.txt
  • Sync Process - How scripts work and what they do
  • Skill Precedence - Local vs repository skill priority
  • Managing Repositories - Adding and removing sources
  • Troubleshooting - Common issues and solutions
  • Resources - Bundled scripts and their usage

Why Replace the MCP Server?

The MCP server added unnecessary complexity by distributing scripts as resources that agents would download and execute. The skill provides a simpler, more direct approach:

Before (MCP Server):

  1. Agent requests resource from MCP server
  2. Server returns script content
  3. Agent writes script to disk
  4. Agent executes script

After (Skill):

  1. Scripts are already on disk as part of the skill
  2. Agent executes script directly

This eliminates the server dependency while maintaining the same functionality with better performance and simpler deployment.

Example: Adding to Your Project

Option 1: Direct Copy

# Copy the skill to your project
cp -r /path/to/skills-mcp-server/.claude/skills/skills-sync /path/to/your/project/.claude/skills/

# Run sync
python3 .claude/skills/skills-sync/scripts/sync-skills.py

Option 2: Repository Reference

Add to your .claude/skills/repos.txt:

https://github.com/sfc-gh-dflippo/skills-mcp-server

The skill will be pulled in on next sync and available as skills-sync.

License

Apache-2.0

Links