About Claude Skill Builder
Claude Skill Builder is an MCP server published by jaystarz1 in the Developer Tools category: this is a meta Claude Skill builder that helps you build Claude Skills.
The repository has 6 stars and 1 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/jaystarz1/Claude-Skill-BuilderThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Claude Skill Builder
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 6 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- !Dependencies pinnedNo lockfile. Installs can pull different code over time.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
Skills-Builder
Create world-class Claude Skills that work on your actual filesystem!
A comprehensive skill-builder that creates production-ready Claude Skills following all official Anthropic guidelines. Automatically detects your home directory and creates skills in ~/skills/ with dynamic path detection that works for any user.
✨ Features
- 🎯 Dynamic Path Detection - Works for any user on any platform (Mac, Linux, Windows)
- 📁 Persistent Files - Creates skills on your actual filesystem, not temporary containers
- 📦 Automatic ZIP Creation - Skills are automatically packaged and ready to upload
- 🔄 Git Integration - Optional pre-commit hooks auto-rebuild ZIPs on every commit
- 🔗 Claude Code Integration - Automatic symlinks make skills work in Claude Desktop AND Claude Code
- 🚀 API Deployment Scripts - Ready-to-run scripts for deploying to Anthropic API (organization-wide)
- ✅ Full Validation - Checks all requirements before creating skills
- 📚 Progressive Disclosure - Supports reference files, examples, and code helpers
- 🔒 Security First - Never uses temporary or container directories
🚀 Quick Start
1. Set Up MCP Servers
Before using skills-builder, you need two MCP servers:
Required:
- Filesystem MCP - Lets Claude create files on your computer
Recommended:
- Zip Creator MCP - Automatically packages skills (has Python fallback if not installed)
📖 Complete Setup Guide: SETUP.md
Quick links:
- Filesystem MCP Guide - Includes link to complete Google Doc
- Zip Creator MCP Guide - Step-by-step installation
2. Upload to Claude Desktop
- Download
skills-builder.zipfrom this repository - Open Claude Desktop
- Go to Settings → Capabilities
- Click "Upload skill"
- Select
skills-builder.zip - Start a new chat!
3. Create Your First Skill
User: "Create a skill that helps me write meeting notes"
Claude:
✅ Detected skills directory: /Users/yourname/skills/
✅ Creating skill at: /Users/yourname/skills/meeting-notes/
✅ Created meeting-notes.zip (ready to upload)
Your skill is ready! Upload meeting-notes.zip to Claude Desktop.
📖 What This Does
The skills-builder creates Claude Skills that:
- ✅ Work on claude.ai, API, and Claude Code
- ✅ Follow all Anthropic specifications and best practices
- ✅ Include comprehensive documentation and examples
- ✅ Auto-generate ZIP files ready for upload
- ✅ Validate naming conventions and structure
- ✅ Support progressive disclosure for complex workflows
- ✅ Include update instructions (UPDATING.md)
🗂️ Directory Structure
After setup, your files will look like:
~/skills/ # Your skills directory
├── meeting-notes/ # Example skill
│ ├── SKILL.md # Main skill definition
│ ├── meeting-notes.zip # Auto-generated ZIP
│ ├── UPDATING.md # Update instructions
│ ├── examples/ # Optional: example outputs
│ └── references/ # Optional: reference docs
│
└── another-skill/
└── ...
🎓 How to Use
Creating a New Skill
"Create a skill that [describes what you want]"
The skills-builder will:
- Ask clarifying questions about the skill's purpose
- Request examples (highly recommended!)
- Create the skill structure
- Generate all necessary files
- Create a ZIP file automatically
- Tell you where to upload it
Updating an Existing Skill
"Update the [skill-name] skill to [describe changes]"
The skills-builder will:
- Locate the existing skill
- Make the requested changes
- Recreate the ZIP file
- Remind you to upload the new version
Example Requests
Simple skill:
"Create a skill that formats JSON nicely"
Complex skill with examples:
"Create a skill for writing legal briefs. I'll provide example briefs to use as templates."
Skill update:
"Update the meeting-notes skill to add a section for action items"
🔧 Requirements
For Skills-Builder to Work:
-
Filesystem MCP installed and configured
- Gives Claude access to create files on your computer
- Required for persistent file creation
- See setup guide
-
Claude Desktop (Pro, Team, or Enterprise)
- Required to upload and use custom skills
Optional but Recommended:
- Zip Creator MCP installed
- Faster, more reliable ZIP creation
- Falls back to Python if not installed
- See setup guide
📋 Features in Detail
Dynamic Path Detection
Works for any user on any platform:
- Checks for
$SKILLS_DIRenvironment variable - Falls back to
~/skills/directory - Auto-creates the directory if it doesn't exist
- No hardcoded paths - works for everyone!
Automatic ZIP Creation
Every skill is automatically packaged:
- Uses zip-creator MCP if available
- Falls back to Python script if not
- Excludes
.git/,__pycache__/, etc. - One ZIP file per skill (overwrites previous)
Git Integration (Optional)
If your skill is in a git repo:
- Auto-sets up pre-commit hook
- Rebuilds ZIP on every commit
- ZIP stays in sync with code
- No manual ZIP recreation needed
Claude Code Integration (Optional)
If you have Claude Code installed:
- Auto-creates symlink from
~/.claude/skills/to~/skills/ - Skills work in BOTH Claude Desktop AND Claude Code
- Updates automatically sync to Claude Code
- One source of truth - no file duplication
API Deployment Scripts (Always Included)
Every skill includes ready-to-run deployment scripts:
- Bash script (
deploy-to-api.sh) - For Unix/Mac/Linux users - Python script (
deploy-to-api.py) - Cross-platform option - Pre-filled with correct skill name and ZIP filename
- Error handling and validation built-in
- Deploy to Anthropic API with one command
- Makes skills organization-wide (all team members get access)
Comprehensive Validation
Before creating any skill:
- ✅ Validates skills directory exists
- ✅ Checks filesystem MCP is available
- ✅ Verifies naming conventions
- ✅ Confirms no reserved words used
- ✅ Checks all requirements met
Update Tracking
Every skill includes:
UPDATING.md- Instructions for updating- Clear reminders about ZIP recreation
- Links to tools and documentation
🎯 Skill Quality
Skills-builder creates professional-quality skills that:
- Follow Anthropic's best practices
- Use proper naming conventions (lowercase-with-hyphens)
- Include WHAT the skill does AND WHEN to use it
- Have clear, actionable procedures
- Include examples when provided
- Work across all Claude platforms
📚 Documentation
- SETUP.md - Complete setup guide for new users
- SKILL.md - Full skills-builder documentation
- UPDATES.md - Recent changes and improvements
- reference/ - MCP setup guides
🔒 Security
The skills-builder:
- ✅ Never uses temporary or container directories
- ✅ Only creates files in
~/skills/(or$SKILLS_DIR) - ✅ Validates all paths before operations
- ✅ Uses filesystem MCP with proper permissions
- ✅ Clear error messages for security issues
🐛 Troubleshooting
"Skills directory not found"
Problem: Can't find or create ~/skills/
Solution:
- Make sure filesystem MCP has access to your home directory
- Check config paths are absolute
- Restart Claude Desktop
"ZIP creation failed"
Problem: Zip-creator MCP not working
Solution:
- Skills-builder automatically falls back to Python
- Install zip-creator MCP for best experience (see guide)
"Access denied" errors
Problem: Filesystem MCP doesn't have permission
Solution:
- Add your home directory to filesystem MCP config
- Verify paths are absolute
- Restart Claude Desktop after config changes
See SETUP.md for complete troubleshooting guide.
🤝 Contributing
Contributions welcome! To contribute:
- Fork this repository
- Make your changes
- Test with the skills-builder skill
- Submit a pull request
Areas for contribution:
- Additional example skills
- Improved documentation
- Better error messages
- Platform-specific fixes
📄 License
MIT License - See LICENSE file for details
🙏 Acknowledgments
- Built using Anthropic's MCP SDK
- Follows Claude Skills specifications
- Inspired by the Claude developer community
📞 Support
- Issues: Open an issue in this repository
- Questions: Check SETUP.md and SKILL.md first
- Filesystem MCP: See the complete guide
- MCP SDK: https://github.com/modelcontextprotocol/sdk
🎉 Get Started
Ready to build skills?
- Read SETUP.md - Set up MCP servers
- Upload skills-builder.zip to Claude Desktop
- Create your first skill!
"Create a skill that helps me organize my project notes"
Happy skill building! 🚀
README fetched from the repository 6 days ago. The original is authoritative.