🚀 What's New in v0.2.0

Major Features

🔄 New reset_skills Tool

Safely remove all installed skills and start fresh
Options to clear configuration and cache
Support for resetting all agents at once
Comprehensive error handling and user guidance

📊 Testing & Development

Added comprehensive test coverage for reset functionality
New test-registry utility script for testing registry fetching
Enhanced test suite for config management

📣 Marketing Materials

Gamma infographic and presentation scripts for community outreach
Professional documentation assets

Improvements

Enhanced documentation with new tool information
Updated CHANGELOG with detailed feature descriptions
Better error handling across all tools

Installation

npm install -g mcp-mother-skills

Or use with npx:

npx mcp-mother-skills

Full Changelog

See CHANGELOG.md for complete details.

What's Next: Working on enhanced detection capabilities and more registry providers for v0.3.0!

🎉 Mother MCP Skills v0.1.2 - First Release

TL;DR: Mother MCP is an intelligent skill manager for AI coding agents (Claude, Copilot, Codex) that automatically detects your project's tech stack and provisions relevant skills from a centralized registry.

🚀 What is Mother MCP Skills?

Mother MCP Skills is a Model Context Protocol (MCP) server that acts as a dynamic skill provisioning system for AI coding agents. Instead of manually managing skill files, Mother automatically:

🔍 Detects your project's technologies - Scans your codebase to identify languages, frameworks, databases, and tools
🎯 Finds matching skills - Searches a curated registry of 29+ skills from Anthropic, OpenAI, and GitHub
📦 Installs automatically - Downloads relevant skills to the right location for your agent
🔄 Keeps them updated - Syncs skills as your project evolves

Why Mother MCP?

Problem: AI agents need context-specific skills to work effectively, but managing skill files manually across projects is tedious and error-prone.

Solution: Mother MCP automates the entire skill lifecycle - detection, installation, updates, and cleanup - so your AI agent always has the right capabilities for your project.

🌟 Key Features

🎯 Multi-Agent Support

Works seamlessly with:

✅ Claude Code - Auto-detected via environment
✅ Claude Desktop - Auto-detected via MCP client info
✅ GitHub Copilot - Auto-detected in VS Code
✅ OpenAI Codex - Auto-detected via CODEX_HOME
✅ Generic MCP Clients - Fallback support

🔬 3-Tier Tech Stack Detection

Tier 1: GitHub SBOM API (Most Accurate)

Queries GitHub's dependency graph directly
Supports 340+ packages across ecosystems (npm, pip, cargo, maven, etc.)
PURL (Package URL) parsing for ecosystem detection

Tier 2: Specfy Stack Analyser

Detects 700+ technologies including infrastructure & SaaS
Identifies cloud platforms, databases, CI/CD tools, and more
Comprehensive framework and tool detection

Tier 3: Local File Scanning (Offline Fallback)

Parses package.json, requirements.txt, config files
README.md keyword extraction
Works without internet connection

📚 Curated Skills Registry

Access to 29+ professional skills from trusted sources:

Provider	Skills	Examples
Anthropic	16	`pdf`, `docx`, `pptx`, `xlsx`, `frontend-design`, `mcp-builder`
OpenAI	10	`webapp-testing`, `create-plan`, `skill-creator`
GitHub	3	`gh-fix-ci`, `gh-address-comments`

Skill Categories:

📄 Documents & Data: PDF, DOCX, PPTX, XLSX processing
🎨 Creative & Design: Frontend design, branding, artifacts
🛠️ Development: Testing, MCP server building, CI/CD
📊 Communication: Internal comms, doc collaboration

🚀 Quick Onboarding

New setup command provides guided first-time experience:

Setup my Mother MCP

Features:

📊 Full project scan with tech stack detection
🎯 Confidence-scored skill recommendations (High/Good/Possible)
💬 Clear explanations for why each skill matches
⚡ Optional one-click auto-install
📝 Actionable next steps

📦 Installation

npm (Recommended)

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

# Or install globally
npm install -g mcp-mother-skills

From Source

git clone https://github.com/dmgrok/mcp-mother-skills.git
cd mcp-mother-skills
npm install && npm run build

⚙️ Configuration

Claude Code / Claude Desktop

Add to .mcp.json or Claude config:

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

VS Code with GitHub Copilot

Add to .vscode/mcp.json:

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

🎮 Usage

First-Time Setup

Setup my Mother MCP

Shows:

Detected technologies in your project
Recommended skills with match explanations
Already installed skills
Next steps

Ongoing Usage

Sync skills for this project

Automatically:

Detects new technologies
Downloads matching skills
Updates existing skills
Reports changes

Available Commands

Command	Purpose
`setup`	Start here! Guided onboarding with recommendations
`sync_skills`	Synchronize skills based on detected stack
`get_project_context`	View detected technologies and skills
`search_skills`	Find available skills by name/tag
`install_skill`	Manually add a specific skill
`uninstall_skill`	Remove a skill
`check_updates`	Check for newer skill versions
`set_agent_preference`	Override agent detection
`redetect`	Re-scan project files

📂 Project Structure

Mother MCP creates a .mcp/mother/ directory:

.mcp/mother/
├── config.yaml           # User preferences
├── project-context.yaml  # Auto-detected context
└── cache/               # Registry cache (7-day TTL)

Skills are installed to:

Claude: .claude/skills/
Copilot: .github/skills/
Codex: .codex/skills/ (Open Agent Skills Standard)

🔬 Technical Highlights

Architecture

Mother MCP Server
├── Agent Detection     → Identifies Claude/Copilot/Codex
├── Project Detection   → 3-tier tech stack analysis
├── Registry Client     → Fetches skills from CDN
├── Skill Installer     → Downloads and manages skills
└── Config Manager      → YAML configuration handling

Tech Stack

TypeScript with ES2022 target
MCP SDK v1.0+ for protocol handling
Specfy Stack Analyser for tech detection
Vitest for comprehensive testing (140 tests)
YAML for human-friendly configuration

Package-to-Skill Matching

Smart mapping system with 40+ package-to-framework rules:

react → React framework skill
express → Node.js/Express skill
fastapi → Python/FastAPI skill
@aws-sdk/* → AWS skill
And many more...

📊 Detection Examples

Node.js + React + PostgreSQL Project

Detected Stack:

Languages: JavaScript, TypeScript
Frameworks: React, Express
Databases: PostgreSQL
Tools: Webpack, Jest, ESLint

Installed Skills:

react-best-practices
nodejs-server
postgresql-optimization
frontend-testing

Python + FastAPI + MongoDB Project

Detected Stack:

Languages: Python
Frameworks: FastAPI
Databases: MongoDB
Tools: Pytest, Black, Ruff

Installed Skills:

python-fastapi
mongodb-queries
python-testing
api-design

🗺️ Roadmap

v0.2.0 (Planned)

🔌 Plugin system for custom registries
🎨 Skill templates and generators
📈 Analytics and skill usage tracking
🌍 Multi-registry support

v0.3.0 (Planned)

🤖 AI-powered skill recommendations
🔗 Skill dependency resolution
📦 Private registry support
🏢 Team/organization configurations

🤝 Contributing

We welcome contributions! Areas of interest:

🆕 New skill definitions for the registry
🔍 Enhanced detection for more frameworks
🐛 Bug reports and fixes
📚 Documentation improvements
🧪 Test coverage expansion

See CONTRIBUTING.md for guidelines.

📄 License

MIT License - See LICENSE file

🔗 Links

npm Package: https://www.npmjs.com/package/mcp-mother-skills
GitHub Repository: https://github.com/dmgrok/mcp_mother_skills
Skills Registry: https://github.com/dmgrok/agent_skills_directory
MCP Protocol: https://modelcontextprotocol.io
Open Agent Skills Standard: https://agentskills.io

💬 Support

🐛 Issues: https://github.com/dmgrok/mcp_mother_skills/issues
💡 Discussions: https://github.com/dmgrok/mcp_mother_skills/discussions
📧 Email: support@example.com

🙏 Acknowledgments

Anthropic for the MCP protocol and Claude skills
OpenAI for Codex skills and Open Agent Skills Standard
GitHub for Copilot skills and dependency graph API
Specfy for the comprehensive stack analyzer

🎉 Getting Started

Install: npx mcp-mother-skills
Configure: Add to your agent's MCP config
Setup: Run setup command in your project
Code: Let Mother manage your skills automatically!

Welcome to the future of AI agent skill management! 🚀

Releases: dmgrok/mcp_mother_skills

Release list

v0.2.0 - Reset Skills Tool & Enhanced Documentation

🚀 What's New in v0.2.0

Major Features

Improvements

Installation

Full Changelog

Uh oh!