The npm for AI Skills

Stop Configuring AI Skills.
Start Building.

Just like npm installs the right packages, Mother MCP installs the right AI skills for your stack. No manual config. No context switching. Just setup and code.

Quick Install via Claude Code Plugin
/plugin marketplace add dmgrok/mcp_mother_skills /plugin install mother-mcp@mother-mcp-marketplace
Or via NPM
npm install -g mcp-mother-skills
700+
Technologies Detected
3-Tier
Detection Strategy
4 Agents
Claude, Copilot, Codex, Vercel
Terminal
$ setup
🔍 Scanning: package.json, tsconfig.json...
📦 Detected: React, TypeScript, Next.js
💡 Recommending: frontend-design
💡 Recommending: webapp-testing
💡 Recommending: mcp-builder
🎯 3 skills recommended for your project

Why Reusable Skills Beat Ad-Hoc Prompts

"If you'll do roughly the same thing 10+ times, encode it as a skill. Under 3 times? Just prompt."

❌ The "Prompt Tax" (Every Time)

Hey Claude, review this PR for security issues. Check for SQL injection, XSS, also we use React so watch for dangerouslySetInnerHTML, and our team prefers early returns, and don't forget we have a custom auth middleware pattern, and...

Re-typed variations. Inconsistent results. Teammates can't find "that good prompt you used."

✅ With Mother Skills

/review

Skill knows your framework, patterns, and team standards — installed from your actual project context.

⏱️

Prompt Tax

Re-typing similar prompts wastes hours weekly

Skills encode best practices once, reuse forever

🎯

Consistency

Small phrasing changes alter AI behavior

Versioned skills deliver predictable results

🔍

Discoverability

"What was that prompt you used last month?"

Named skills with descriptions, searchable

👥

Team Standards

Everyone crafts prompts differently

Shared skills encode house style

Developer Pain Points, Solved

Real problems developers face every day with AI assistants.

🔥

Context Switching Hell

Jumping between React, Python, and Rust projects? Your AI forgets everything between sessions.

Instant Stack Adaptation

Mother detects your stack and loads the right skills. Every. Single. Time.

💀

Onboarding Nightmare

New teammate spends 2 hours configuring AI skills. Then does it wrong anyway.

🚀

Zero-Config Onboarding

Clone repo → sync_skills → Done. Perfect AI context in 5 seconds.

🎪

Manual Skill Circus

Editing .github/skills/ manually across 10 microservices. Skills get stale. Nobody updates them.

🎯

Auto-Sync Everything

Skills update when your dependencies change. Always current. Zero maintenance.

🔀

Agent Lock-In

Want to try Copilot but your team uses Claude? Reconfigure everything from scratch.

🔄

Agent Agnostic

Switch between Claude, Copilot, and Codex. Context follows you automatically.

Before & After Mother

See what you're missing.

Without Mother

  • 30+ minutes per project Finding and copying skills from 5 different repos
  • Manually edit .github/copilot-instructions.md Every time dependencies change
  • Skills become stale AI gives outdated advice for your stack
  • Onboarding confusion "Which skills do I need? Where do I get them?"
  • Different setup per agent Claude ≠ Copilot ≠ Codex configs
VS

With Mother

  • 5 seconds per project Just run sync_skills
  • Zero manual editing Mother handles all skill management automatically
  • Always current Skills sync with your actual dependencies
  • Instant onboarding New devs get perfect setup in seconds
  • One setup for all agents Auto-detects and adapts to Claude/Copilot/Codex

Built for Developer Workflows

Real scenarios where Mother saves you hours.

🔄

Polyglot Projects

The Problem: Frontend in React, backend in Python, infra in Terraform. Your AI is confused.

Mother's Solution: Detects all languages, loads relevant skills for each. Your AI becomes a polyglot too.

📦

Monorepo Teams

The Problem: Different packages need different skills. Manual config nightmare across 20+ packages.

Mother's Solution: Per-package skill detection. Each service gets exactly what it needs, automatically.

🌐

Microservices

The Problem: API service needs different skills than frontend. Skills leak between services.

Mother's Solution: Context-aware per-service skills. No cross-contamination. Perfect isolation.

🤝

Open Source Contributions

The Problem: Clone repo → spend 20 minutes configuring AI → finally start contributing.

Mother's Solution: Clone → sync_skills → contribute. Zero friction from discovery to first PR.

🔧

Framework Migrations

The Problem: Moving from Webpack to Vite? Your AI still suggests Webpack configs.

Mother's Solution: Detects new dependencies, updates skills automatically. AI adapts as you migrate.

👥

Team Consistency

The Problem: Everyone has different AI skills. Inconsistent code patterns across the team.

Mother's Solution: Shared config means everyone gets the same skills. Consistent patterns, always.

Supported AI Agents

One server, all your favorite AI coding assistants.

Claude Code

Full support with auto-detection via environment variables and MCP client info.

✅ Full Support

GitHub Copilot

Seamless VS Code integration. Skills installed to .github/skills automatically.

✅ Full Support

OpenAI Codex

Follows the Open Agent Skills Standard. Compatible with AGENTS.md workflow.

✅ Full Support

Vercel v0

Skills optimized for v0's AI-powered frontend generation and deployment workflow.

✅ Full Support

Agent Detection Priority

Priority Method Example
1 Config Override agent.force: claude
2 Environment Variables CLAUDE_CODE=1, GITHUB_COPILOT, CODEX_HOME
3 MCP Client Info Client name contains "claude", "copilot", or "codex"
4 Project Structure .claude/, .github/copilot-instructions.md, AGENTS.md
5 Home Directory ~/.claude/skills/, ~/.copilot/skills/

How It Works

From detection to installation in seconds.

1

Detect

Mother uses a 3-tier detection strategy for comprehensive tech stack analysis.

GitHub SBOM → 340+ packages from dependency graph
Specfy Analyser → 700+ technologies, infrastructure, SaaS
Local Scanning → package.json, requirements.txt, configs
Git Remote → Auto-detects GitHub repo from .git/config
2

Match

Compares detected technologies against the skill registry to find relevant skills.

React frontend-design
Next.js webapp-testing
MCP mcp-builder
3

Install

Downloads skills to the appropriate directory for your AI agent.

Claude .claude/skills/
Copilot .github/skills/
Codex .codex/skills/

Enhanced Detection

3-tier strategy for comprehensive tech stack analysis.

Tier 1

🔗 GitHub SBOM API

Most Accurate — Fetches the Software Bill of Materials directly from GitHub's dependency graph.

  • 340+ packages from dependency graph
  • Auto-detects repo from git remote URL
  • PURL parsing for ecosystem detection
  • Supports npm, pip, cargo, maven, go, nuget
GITHUB_TOKEN=ghp_xxx sync_skills
Tier 2

📊 Specfy Analyser

Most Comprehensive — Detects 700+ technologies including infrastructure and SaaS.

  • Languages, frameworks, databases
  • Cloud services (AWS, GCP, Azure)
  • CI/CD systems (GitHub Actions, CircleCI)
  • Monitoring & analytics tools
Works offline with local analysis
Tier 3

📁 Local Fallback

Always Available — Traditional file scanning for offline environments.

  • package.json, requirements.txt
  • Config files (tsconfig, Dockerfile)
  • pyproject.toml, Cargo.toml, go.mod
  • README.md keyword extraction
No external dependencies

🔍 Automatic Git Remote Detection

Mother automatically detects your GitHub repository from local git configuration:

git@github.com:owner/repo.git https://github.com/owner/repo.git ssh://git@github.com/owner/repo

Available Skills

Curated from Anthropic, OpenAI, GitHub, and the community.

📄 Documents & Data

pdf docx pptx xlsx doc-coauthoring

🎨 Creative & Design

frontend-design canvas-design theme-factory brand-guidelines algorithmic-art web-artifacts-builder

💻 Development

mcp-builder skill-creator webapp-testing create-plan gh-fix-ci gh-address-comments

🏢 Enterprise

linear slack-gif-creator notion-spec-to-implementation notion-meeting-intelligence azure-role-selector

Skills are fetched from the Agent Skills Directory, an automatically updated catalog.

Skill Sources

Curated from the best AI agent skill repositories.

🏢 Bring Your Own Registry

Want skills tailored for your organization? The registry URL is fully configurable:

# .mcp/mother/config.yaml
registry:
  # Use your company's private registry
  - url: "https://skills.yourcompany.com/catalog.json"
    priority: 1
  
  # Optionally keep the public registry as fallback
  - url: "https://cdn.jsdelivr.net/gh/dmgrok/agent_skills_directory@main/catalog.json"
    priority: 2
✅ Curate skills for your organization's stack
✅ Add proprietary skills with internal knowledge
✅ Control what skills are available to teams
✅ Version and audit through your infrastructure

Automatic & Manual Skills

Let Mother detect skills automatically, or take full control.

🤖

Automatic Detection

Recommended

Mother scans your project and installs matching skills automatically.

📄 package.json
react next typescript
✓ frontend-design ✓ webapp-testing
sync_skills Run at start of each session

Detection Sources

  • package.json — npm dependencies
  • requirements.txt — Python packages
  • pyproject.toml — Python projects
  • Cargo.toml — Rust crates
  • go.mod — Go modules
  • *.config.js — Framework configs
  • Dockerfile — Docker projects
  • README.md — Keyword extraction
🎯

Manual Installation

Full Control

Search and install specific skills by name when you need them.

Search search_skills "design"
frontend-design canvas-design brand-guidelines
Install install_skill "canvas-design"
search_skills "query" Find skills by name or keyword
install_skill "name" Install a specific skill
uninstall_skill "name" Remove an installed skill

Always Include/Exclude

Configure in .mcp/mother/config.yaml:

skills:
  always_include:
    - mcp-builder
    - skill-creator
  always_exclude:
    - deprecated-skill

📦 Skill Bundles

Curated collections of skills for common development workflows. Install a complete stack with one command.

One Command, Complete Stack

Instead of installing skills one by one, get everything you need for React, Next.js, or MCP development in seconds.

Curated & Tested

Bundles are curated from the Agent Skills Directory — real skills that work together.

🏷️

Searchable by Use Case

Find bundles by what you want to build: "SaaS", "mobile app", "AI assistant", or browse by category.

Featured Bundles

⚛️

frontend-react

Frontend

Modern React development with testing and best practices

react-best-practices frontend-design webapp-testing
🚀

fullstack-nextjs

Full-Stack

Complete Next.js stack with deployment

vercel-react vercel-deploy backend-development
🤖

mcp-development

Development

Build Model Context Protocol servers

mcp-builder skill-creator make-skill-template
🤗

huggingface-ml

Data/ML

Machine learning with HuggingFace

huggingface-cli datasets model-trainer
📄

documents

Documents

Create PDFs, DOCX, PPTX, and spreadsheets

pdf docx pptx xlsx
🐙

devops-github

Development

GitHub CLI, Actions, and CI/CD workflows

gh-cli git-commit github-issues

How to Use Bundles

1. Browse
list_bundles

See all available bundles with descriptions

2. Search
list_bundles query="react"

Filter by name, description, or use case

3. Install
install_bundle "frontend-react"

Install all skills in the bundle at once

Bundle Categories

Frontend Full-Stack Backend Development Documents Creative Enterprise Data/ML

18 curated bundles across 8 categories. View all bundles →

Quick Setup

Get Mother MCP running in under 5 minutes.

1. Install

Recommended: Claude Code Plugin

Easiest way to get started in Claude Code:

bash
/plugin marketplace add dmgrok/mcp_mother_skills
/plugin install mother-mcp@mother-mcp-marketplace

Alternative: NPM Package

For manual configuration or other agents:

bash
# Install globally
npm install -g mcp-mother-skills

# Or use with npx (no install needed)
npx mcp-mother-skills

For Developers: Build from Source

For development or custom modifications:

bash
git clone https://github.com/dmgrok/mcp_mother_skills.git
cd mcp_mother_skills
npm install
npm run build

2. Configure Your Agent

Add to your project's .mcp.json:

Using NPM Package (Recommended)

json
{
  "mcpServers": {
    "mother-skills": {
      "command": "npx",
      "args": ["mcp-mother-skills"],
      "env": {
        "MOTHER_PROJECT_PATH": "."
      }
    }
  }
}

Using Local Build

json
{
  "mcpServers": {
    "mother-skills": {
      "command": "node",
      "args": ["/path/to/mcp_mother_skills/dist/index.js"],
      "env": {
        "MOTHER_PROJECT_PATH": "."
      }
    }
  }
}

Add to your .vscode/mcp.json:

Using NPM Package (Recommended)

json
{
  "mcp.servers": {
    "mother-skills": {
      "command": "npx",
      "args": ["mcp-mother-skills"],
      "env": {
        "MOTHER_PROJECT_PATH": "${workspaceFolder}"
      }
    }
  }
}

Using Local Build

json
{
  "mcp.servers": {
    "mother-skills": {
      "command": "node",
      "args": ["${workspaceFolder}/path/to/mcp_mother_skills/dist/index.js"],
      "env": {
        "MOTHER_PROJECT_PATH": "${workspaceFolder}"
      }
    }
  }
}

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

Using NPM Package (Recommended)

json
{
  "mcpServers": {
    "mother-skills": {
      "command": "npx",
      "args": ["mcp-mother-skills"],
      "env": {
        "MOTHER_PROJECT_PATH": "/path/to/your/project"
      }
    }
  }
}

Using Local Build

json
{
  "mcpServers": {
    "mother-skills": {
      "command": "node",
      "args": ["/path/to/mcp_mother_skills/dist/index.js"],
      "env": {
        "MOTHER_PROJECT_PATH": "/path/to/your/project"
      }
    }
  }
}

Add to your project's .v0/mcp.json:

Using NPM Package (Recommended)

json
{
  "mcpServers": {
    "mother-skills": {
      "command": "npx",
      "args": ["mcp-mother-skills"],
      "env": {
        "MOTHER_PROJECT_PATH": "."
      }
    }
  }
}

Using Local Build

json
{
  "mcpServers": {
    "mother-skills": {
      "command": "node",
      "args": ["/path/to/mcp_mother_skills/dist/index.js"],
      "env": {
        "MOTHER_PROJECT_PATH": "."
      }
    }
  }
}

3. Add Project Instructions

Add these instructions to your project so Mother MCP auto-initializes at the start of each session.

Add to .github/copilot-instructions.md:

markdown
## Startup

At the start of each conversation, call `setup` (for first-time use) 
or `sync_skills` (for ongoing updates) to ensure project-relevant 
skills are loaded.

Add to CLAUDE.md in your project root:

markdown
## Startup

At the start of each conversation, call `setup` (for first-time use) 
or `sync_skills` (for ongoing updates) to ensure project-relevant 
skills are loaded.

Add to AGENTS.md in your project root:

markdown
## Startup

At the start of each conversation, call `setup` (for first-time use) 
or `sync_skills` (for ongoing updates) to ensure project-relevant 
skills are loaded.

Add to .cursorrules in your project root:

markdown
## Startup

At the start of each conversation, call `setup` (for first-time use) 
or `sync_skills` (for ongoing updates) to ensure project-relevant 
skills are loaded.

Add to .v0/instructions.md in your project root:

markdown
## Startup

At the start of each conversation, call `setup` (for first-time use) 
or `sync_skills` (for ongoing updates) to ensure project-relevant 
skills are loaded.

4. Use It

Start a conversation and say:

Setup my Mother MCP

That's it! Mother will detect your project, show recommendations, and let you install matching skills.

Available Commands

Everything you need to manage skills.

setup

Start here! Initialize Mother MCP, scan your project, and get skill recommendations.

sync_skills

Synchronize skills based on detected technologies. Run this to keep skills up to date.

get_project_context

View detected stack and installed skills.

get_agent_info

See which AI agent is detected.

search_skills

Search for available skills by name or keyword.

list_bundles

NEW! Browse curated skill bundles by category or use case.

install_bundle

NEW! Install a complete skill bundle at once.

install_skill

Manually install a specific skill.

uninstall_skill

Remove an installed skill.

check_updates

Check for skill updates.

redetect

Re-scan project files.

reset_skills

Start fresh - Remove all installed skills and optionally clear config.

Stop Wasting Time on AI Config.
Start Building Better Software.

Join developers who've automated their AI skills and reclaimed hours every week.

# Install Mother MCP
$ git clone github.com/dmgrok/mcp_mother_skills
$ npm install && npm run build
# Configure once, use forever
$ sync_skills
Done. Your AI is ready.

Community & Roadmap

Building the npm for AI skills — together.

Quality Signals

Coming soon: Skill ratings, download counts, verified publishers, and reviews from the community.

  • ⭐ Upvote/downvote skills
  • 📊 Download/install counts
  • ✓ Verified publisher badges
  • 💬 Reviews & use cases
Planned
📤

Easy Publishing

Publish your skills to the registry with a simple CLI command. Templates and guides included.

  • 📤 mother publish CLI
  • 📦 Skill templates
  • 🔀 Fork & customize
  • 📚 Curated collections
Planned
🤝

How You Can Help

Join us in building the best AI skills ecosystem. Every contribution matters.

  • ⭐ Star useful skills
  • 🐛 Report outdated advice
  • ✨ Contribute new skills
  • 💡 Share your use cases
Join the Discussion