A meta-skill repository for creating Custom Skills for Claude.
This repository contains Skill Weaver, a Custom Skill that helps you build other Custom Skills for Claude. It's a comprehensive guide and toolset that ensures your skills follow best practices, proper structure, and security guidelines.
Works on both:
- β claude.ai (ZIP upload)
- β Claude Code (Plugin, Git, or Manual install)
For claude.ai:
- Download latest release (ZIP file)
- Go to Settings β Capabilities β Skills β Upload
- Enable and test: "Create a skill for code reviews"
For Claude Code:
# Via Plugin Marketplace (recommended)
/plugin marketplace add flashingcursor/skill-weaver-marketplace
/plugin install skill-creator
# Or via Git
git clone https://github.com/flashingcursor/skill-weaver.git
cp -r skill-weaver/skill-creator ~/.claude/skills/
# Restart Claude Codeπ Detailed Instructions: See INSTALLATION.md for step-by-step guides, troubleshooting, and all installation methods.
Want to distribute this skill to your team or organization?
π₯ See SHARING.md for:
- Distribution methods for teams
- Plugin marketplace setup
- Team rollout guides
- Announcement templates
- Best practices for adoption
Once installed, try these prompts:
"Create a new skill for [your purpose]"
"Help me build a skill that does [task]"
"Create a skill for code reviews"
"Build a skill for analyzing CSV data"
# Clone the repository
git clone https://github.com/flashingcursor/skill-weaver.git
cd skill-weaver
# Validate the skill
python .github/scripts/validate-skill.py skill-creator
# Package the skill
./scripts/package-skill.sh- Comprehensive Skill Creation Guide: Step-by-step instructions for building Custom Skills
- Templates: Ready-to-use templates for basic and advanced skills
- Script Examples: Python and JavaScript templates with best practices
- Automated Validation: CI/CD workflows to ensure quality
- Automated Releases: GitHub Actions for packaging and distribution
- Security Scanning: Built-in checks for common security issues
- Progressive Disclosure: Teaches Claude's efficient loading system
skill-weaver/
βββ .github/
β βββ workflows/
β β βββ validate.yml # Validation workflow
β β βββ release.yml # Release automation
β βββ scripts/
β βββ validate-skill.py # Skill validation script
β βββ update-version.py # Version updater
β βββ generate-release-notes.py # Release notes generator
βββ scripts/
β βββ package-skill.sh # Local packaging script
βββ weaver-create/
βββ Skill.md # Main skill file
βββ README.md # Skill documentation
βββ REFERENCE.md # Technical reference
βββ templates/
βββ basic-skill-template.md
βββ advanced-skill-template.md
βββ example-script.py
βββ example-script.js
Every push and pull request triggers validation checks:
- β YAML frontmatter structure and field validation
- β Semantic versioning compliance
- β Security scanning for hardcoded secrets
- β Python and JavaScript syntax validation
- β Documentation completeness
- β File reference integrity
View workflow: .github/workflows/validate.yml
When you push a version tag, the pipeline automatically:
- Validates the skill structure
- Updates version in Skill.md
- Packages into a ZIP file
- Generates release notes
- Creates a GitHub release
- Uploads the package as an artifact
Create a release:
git tag v1.0.0 -m "Release version 1.0.0"
git push origin v1.0.0View workflow: .github/workflows/release.yml
# Validate skill structure
python .github/scripts/validate-skill.py skill-creator
# Check Python scripts
python -m py_compile weaver-create/templates/*.py
# Check JavaScript scripts
node --check weaver-create/templates/*.js
# Package locally
./scripts/package-skill.sh- Update the version in
weaver-create/Skill.md - Update the version history in
weaver-create/README.md - Commit your changes
- Create and push a tag:
git tag v1.1.0 -m "Release version 1.1.0" git push origin v1.1.0 - GitHub Actions will automatically create the release
We follow Semantic Versioning:
- MAJOR: Breaking changes to skill structure or behavior
- MINOR: New features, templates, or capabilities
- PATCH: Bug fixes, documentation updates, typos
Using the Skill Weaver teaches you:
- β How to structure Custom Skills properly
- β YAML frontmatter requirements and best practices
- β Progressive disclosure for efficient loading
- β Script integration with Python and JavaScript
- β Security considerations for skills
- β Testing and validation strategies
- β Packaging and distribution methods
With Skill Weaver, you can build:
- Knowledge Skills: Embed company guidelines, style guides, or documentation
- Workflow Skills: Automate repetitive multi-step processes
- Analysis Skills: Create data processing and reporting workflows
- Integration Skills: Connect Claude to your tools and systems
- Template Skills: Provide reusable templates for common tasks
User: "Create a skill for our company brand guidelines"
Skill Weaver will help you:
1. Structure brand colors, fonts, and logo rules
2. Add example materials
3. Define when to apply the guidelines
4. Package for team distribution
User: "Build a skill that analyzes CSV files and creates reports"
Skill Weaver will help you:
1. Set up Python script with pandas
2. Define input/output formats
3. Add error handling
4. Include example data
5. Test and validate
- INSTALLATION.md - Complete installation guide for all platforms
- SHARING.md - Team distribution and rollout guide
- weaver-create/Skill.md - Main skill instructions
- weaver-create/REFERENCE.md - Technical reference
- weaver-create/README.md - Skill overview
- Skills Documentation: Claude Skills Docs
- Example Skills: Anthropic Skills Repository
- Best Practices: Skill Authoring Guide
We welcome contributions! Here's how you can help:
- Report Issues: Found a bug? Open an issue
- Suggest Features: Have ideas? Start a discussion
- Submit PRs: Improvements welcome!
- Share Skills: Create a skill using Skill Weaver and share your experience
- Follow the existing code style
- Update documentation for changes
- Add tests where applicable
- Ensure CI passes
- Use semantic commit messages
If you discover a security issue, please email us directly rather than opening a public issue.
This project is provided as an example and educational resource for creating Custom Skills for Claude.
Created to help the Claude community build better Custom Skills.
Made with the Skill Weaver skill itself! π¨