skillms

MCP server for maintaining a library of content-strategy and SEO skills in Claude Code.

What it does

skillms is a Model Context Protocol server that connects Claude Code to a local folder of Markdown skill files. It lets Claude:

• Apply skills automatically — reads a skills/ index and applies relevant guidance based on the current task
• Analyze URLs — fetches a page, compares it against existing skills, returns a verdict on whether it's worth adding
• Commit skills — writes or updates a skill file and opens a GitHub PR in the current repo
• Contribute upstream — opens a PR against a central skillms repository

The model

skillms is free. The way you give back is by contributing skills.

When you discover something worth keeping — an article, a framework, a technique — run analyze_url. If it's useful, commit it locally. Then contribute it upstream: your skill goes into the community inbox as a PR, gets reviewed, and if it's good, it joins the shared library that everyone pulls from.

Skills in, skills out.

Setup

claude mcp add skillms --scope project -- npx skillms

Then add a skills/ directory to your project with Markdown files using this frontmatter:

---
title: "Skill Title"
type: skill
description: "One-line description of what this skill does."
use_when: "Describe when Claude should apply this skill."
tags: [tag1, tag2]
---

# Skill content...

Environment variables

| Variable | Required | Description | |---|---|---| | ANTHROPIC_API_KEY | Yes | Used by analyze_url to call Claude | | SKILLMS_ROOT | No | Path to the skills repo (defaults to cwd) | | SKILLMS_UPSTREAM | No | Override the upstream inbox repo (default: ruco-ai/skillms-inbox) |

Tools

| Tool | Description | |---|---| | analyze_url(url) | Fetch a URL and return a verdict on whether it's useful for the skill library | | commit_skill(skill_file, content, rationale, source_url) | Write a skill file and open a PR | | contribute_skill(skill_file) | Open a PR against the upstream central repo |

Resource

| Resource | Description | |---|---| | skills://index | Compact index of all skills — name, description, and use_when for each |

License

MIT