Skills Over MCP — Host any GitHub repo as an MCP server

5 min read Original article ↗

any github repo  →  an mcp serverskills > mcp

v0.4.2

githubConnect

SKILLSOVER MCP.com

/how it works

Turn any GitHub repo of SKILL.md files into an MCP server you can share with your whole team. Why? →

  1. 01Get a public GitHub repo with SKILL.md files.
  2. 02Paste it below — get a stable MCP URL.
  3. 03Add the URL to Claude Code, Cursor, or Codex.

/connect

Three steps. Share the URL.

live · free · public repos

step 01

Get a skills repo

A public repo of SKILL.md files. Each one teaches your agent a task.

step 02

Connect your repo

Paste a GitHub URL. Get back a stable MCP endpoint.

paste your github repo url

step 03

Add to your agent

Drop the URL into any MCP client. Each SKILL.md becomes a tool.

https://mcp.skillsovermcp.com/mcp/<owner>/<repo>

paste into any MCP client's server URL field — transport streamable-http

/anatomy

What's actually in a skills repo?

Folders. Each folder has a SKILL.md file. Each SKILL.md is a markdown playbook the agent reads on demand. That's the whole format.

view the template repo →

spec-compliantagentskills.ioSEP-2640chartertoday: tools + prompts + resources. tomorrow: resources-only, no per-skill tools needed.

spencerpauly/skills-repo — tree

repo layoutclick any file to view it

your-skills-repo/

├─ LICENSE

└─ skills/

│ └─ references/

6 skills · layout-agnosticserved at /mcp/spencerpauly/skills-repo

skills/write-like-a-human/SKILL.md

md·2.7kb·51 ln

---
name: write-like-a-human
description: Strip the AI-isms out of any text — em-dash overuse, "It's not just X, it's Y", inflated significance, sycophantic openers, rule-of-three padding. Use when the user says "humanize this", "make this less AI", "tighten this", or pastes obviously-AI prose and asks for a rewrite.
license: MIT
---

# Write Like a Human

Rewrite text so it stops sounding like a language model wrote it. Wraps the open-source [humanizer](https://github.com/blader/humanizer) skill, which catalogs ~30 specific tells (em-dash overuse, "stands as a testament", `-ing` analyses, rule-of-three padding, inline-bold lists, and so on).

## When to use

- The user pastes a chunk of writing and asks to "humanize", "de-AI", "tighten", or "make this sound like me".
- The user asks for editing on something they wrote with an LLM.
- A blog post / launch email / README draft has tells the user wants gone.

## Steps

1. **Pull down the reference list of patterns** the first time this skill activates in a session:
   ```bash
   curl -fsSL https://raw.githubusercontent.com/blader/humanizer/main/SKILL.md
   ```
   Read it. There are ~30 patterns; you don't need to memorize them, just keep them visible while editing.

2. **Ask for a voice sample** if you don't already have one. One paragraph the user wrote themselves is enough. Match cadence, vocabulary, and how they handle transitions.

3. **Do a first pass** removing the highest-signal tells in this order:
   1. Sycophantic openers ("Great question!", "Absolutely!").
   2. Em-dashes that should be commas, periods, or parens.
   3. "It's not just X, it's Y" / "Not only … but …" parallelisms.
   4. Inflated significance words: *testament, pivotal, landscape, vibrant, tapestry, underscore*.
   5. Rule-of-three lists that pad ideas into groups of three.
   6. Inline-bold vertical lists (`- **Speed:** …`).

4. **Do a second "audit" pass.** Re-read your draft and ask out loud: *"What still makes this sound AI-generated?"* Answer briefly, then revise once more. This step is the difference between "cleaned up" and "actually sounds human".

5. **Return three things:**
   - A draft rewrite.
   - A short list of remaining tells you noticed during the audit.
   - A final rewrite with those fixed.

## Don't

- Don't replace AI mush with new AI mush. If the original said "stands as a testament to" and you change it to "represents a key milestone in", you haven't fixed anything.
- Don't sand off the user's voice. Quirks, opinions, and the occasional sentence fragment are the *point*.
- Don't add em-dashes back in. If you must use a punctuation break, prefer a period.

## Reference

Patterns and examples: <https://github.com/blader/humanizer>

01

Layout-agnostic

Top-level, in skills/, or nested under category folders. Whatever you prefer.

02

Public-only

Today, your repo must be public. Private repos coming with GitHub OAuth.

03

Live on commit

Push to main and the next agent connection picks up the change.

/why this exists

Skills over MCP is the future of how skills get shipped.

Don't take my word for it. The MCP community charter and SEP-2640 are making this the officially recommended way to deploy skills.

/how it works

Skills served over MCP— with a tool-wrapper for clients that haven't caught up.

This MCP serves every SKILL.md over the new skill:// URI scheme defined by the Skills Extension (SEP-2640). The catch: not every MCP client speaks skill:// yet. Until they do, we also expose each skill as an ordinary MCP tool — a temporary shim so older clients still work today.

/the new wayprimary

Skills served natively.

Each skill is exposed at skill://<name>/SKILL.md with an enumerable skill://index.json — the resource pattern from SEP-2640. Clients that speak the extension load them as real skills, no wrapper, no tool boilerplate.

  • +Extension id io.modelcontextprotocol/skills
  • +Claude Code today; more clients rolling out
  • +Progressive disclosure preserved

/the temporary fallbackuntil clients catch up

Each skill also exposed as an MCP tool.

Most MCP clients don't speak skills yet. So for now, every SKILL.md is also wrapped as one MCP tool — frontmatter becomes the schema, body becomes the tool description. The wrapper goes away as clients adopt the skills extension.

  • +Cursor, Codex, Continue, Zed, any MCP client
  • +One tool per skill, descriptions intact
  • +Compat shim — sunset when skills land in your client

$ tl;dr: skills-first, with a wrapper to keep older clients working until they catch up.

/shipping today

Bring your repo,
we'll bring the server.

One URL, infinitely shareable. Push to main and every connected agent gets the new skills — instantly.

/faq

Questions, answered.

The short answers to everything people ask before pasting their first repo URL.

  • An MCP (Model Context Protocol) server exposes tools, resources, and prompts to AI agents like Claude Code, Cursor, and Codex over a standard protocol. Skills Over MCP turns any GitHub repo of SKILL.md files into one.