A self-improving skills manager for Claude Code that discovers, ranks, and optimizes skills from GitHub.
skill-sommelier
A self-improving Claude Code skills manager. It discovers skills from GitHub, ranks them to your profile, installs them, then uses its own skills to validate, optimize, and evolve the collection — a closed loop where the tool improves itself.
The entire system is written in natural language. No Python, no JavaScript — just SKILL.md files that Claude Code executes directly.
Features
- Personalized discovery — searches GitHub for Claude Code skills and ranks them to your stack via
ss-user-profile
- Automated recommendations — weekly GitHub Actions creates issues with new skill suggestions
- Quality enforcement — validates frontmatter, naming conventions, and merges overlapping skills
- Self-improving — optimizes skills through eval loops and adopts community patterns automatically
Skills
Meta Skills
Skills that manage the collection itself — discovery, quality, and evolution.
Discovery
| Skill | Description |
|---|
| ss-skill-discover | Search GitHub for trending Claude Code skills and present a personalized ranked table |
| ss-skill-weekly-discover | Automated weekly skill discovery via GitHub Actions — creates issues with checkbox recommendations |
| ss-user-profile | Analyze Claude Code user history to build a rich profile |
Quality
| Skill | Description |
|---|
| ss-skill-craft | Create, improve, and design Claude Code skills |
| ss-skill-validate | Validate all skills for frontmatter correctness, naming conventions, and structural rules |
| ss-skill-consolidate | Identify and merge overlapping skills to reduce redundancy |
| ss-skill-tune | Self-improving skill optimization using the Karpathy autoresearch pattern |
Repo Management
| Skill | Description |
|---|
| ss-repo-evolve | Discover trending Claude Code skills, study their implementations, and evolve this repo |
| ss-repo-release | Bump version, tag, and push to trigger the GitHub Actions release workflow |
| ss-repo-simplify | Audit a repository for unnecessary complexity and propose concrete simplifications |
| ss-repo-update | Check for plugin updates, show changelog, and apply them |
My Collection
Skills discovered and installed via the sommelier — tailored to your stack.
Python & APIs
| Skill | Description |
|---|
| ss-modern-python | Configure Python projects with modern tooling: uv, ruff, ty |
| ss-fastapi-expert | Build high-performance async Python APIs with FastAPI and Pydantic V2 |
| ss-fastapi-templates | Create production-ready FastAPI projects with async patterns and dependency injection |
| ss-claude-api | Build apps with the Claude API or Anthropic SDK |
ML & Training
| Skill | Description |
|---|
| ss-fine-tuning-expert | Fine-tune LLMs, train custom models, and adapt foundation models for specific tasks |
| ss-pytorch-lightning | High-level PyTorch framework with Trainer, distributed training, and callbacks |
| ss-huggingface-accelerate | Distributed training API for DeepSpeed/FSDP/Megatron/DDP with automatic device placement |
Data & Research
| Skill | Description |
|---|
| ss-database-optimizer | Optimizes database queries and improves performance across PostgreSQL and MySQL systems |
| ss-design-postgres-tables | PostgreSQL table design reference: data types, constraints, indexes, JSONB patterns, partitioning, and best practices |
| ss-arxiv-database | Search and retrieve preprints from arXiv via the Atom API |
DevOps & Containers
| Skill | Description |
|---|
| ss-devops-engineer | Creates Dockerfiles, configures CI/CD pipelines, writes Kubernetes manifests, and generates Terraform/Pulumi infrastructure templates |
| ss-python-to-chtc | Convert Python scripts into production-ready Docker and Apptainer/Singularity containers |
Frontend
| Skill | Description |
|---|
| ss-web-artifacts-builder | Create elaborate HTML artifacts with React, Tailwind CSS, and shadcn/ui |
| ss-make-slides | Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files |
Productivity
| Skill | Description |
|---|
| ss-citation-cff | Generate CITATION.cff files for GitHub repositories with APA and BibTeX export |
| ss-docs-update | Update all documentation (README, docs/, .env.example, etc.) to reflect current repo state |
| ss-cli2task | Generate VS Code tasks.json from Python CLI commands (typer, click, argparse) |
| ss-search-first | Research-before-coding workflow |
Install
/plugin marketplace add JasonLo/skill-sommelier
/plugin install skill-sommelier@skill-sommelier
Skills are namespaced as /skill-sommelier:<skill-name> (e.g., /skill-sommelier:ss-skill-discover).
Update to latest skills: /plugin marketplace update
Quickstart
- Run
/skill-sommelier:ss-user-profile to build your developer profile
- Run
/skill-sommelier:ss-skill-discover to find and install skills tailored to you
Development
git clone https://github.com/JasonLo/skill-sommelier.git
cd skill-sommelier
# Project-level skills work automatically via .claude/skills symlink