From 89eefea8acf7abe1f5b1ce3e41beb7dd39fcf8d4 Mon Sep 17 00:00:00 2001
From: Florian BRUNIAUX <florian@bruniaux.com>
Date: Fri, 23 Jan 2026 18:21:15 +0100
Subject: [PATCH] docs: add skills.sh marketplace documentation (v3.11.5)

Added comprehensive documentation for skills.sh (Vercel Labs) marketplace:

Section 5.5 (Skills Marketplace):
- Installation instructions (npx add-skill <owner/repo>)
- Top skills by category (Frontend, Database, Auth, Testing)
- Format compatibility (100% compatible with .claude/skills/)
- Status & trade-offs (community project, early stage)

Section 11.3 (Skills Distribution Platforms):
- Comparison: skills.sh vs claude-code-templates vs SkillsMP
- When to use each platform (discovery, installation, team-specific)

Updated files:
- guide/ultimate-guide.md: New subsection Skills Marketplace (~line 5172)
- guide/ai-ecosystem.md: New section 11.3 Skills Distribution Platforms
- machine-readable/reference.yaml: Added 7 skills_marketplace_* entries
- README.md: Added skills.sh to Complementary Resources table
- CHANGELOG.md: Detailed entry for v3.11.5
- VERSION: Bumped to 3.11.5
- guide/cheatsheet.md: Version sync

Marketplace stats (Jan 23, 2026):
- 200+ skills available
- Top skill: vercel-react-best-practices (35K+ installs)
- 20+ agents supported (Claude Code, Cursor, Copilot, etc.)
- Launched: January 21, 2026 by Vercel Labs

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
---
 CHANGELOG.md                    | 24 +++++++++
 README.md                       |  5 +-
 VERSION                         |  2 +-
 guide/ai-ecosystem.md           | 61 +++++++++++++++++++++
 guide/cheatsheet.md             |  4 +-
 guide/ultimate-guide.md         | 93 ++++++++++++++++++++++++++++++++-
 machine-readable/reference.yaml | 17 +++++-
 7 files changed, 197 insertions(+), 9 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index cc0db30..51c5b76 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,30 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
+## [3.11.5] - 2026-01-23
+
+### Added
+
+- **skills.sh marketplace documentation** (`guide/ultimate-guide.md:5172`, `guide/ai-ecosystem.md:1284`)
+  - New subsection in Section 5.5: "Skills Marketplace: skills.sh"
+  - Vercel Labs project (launched Jan 21, 2026): centralized skill discovery + one-command install
+  - 200+ skills, leaderboard with 35K+ installs (vercel-react-best-practices top skill)
+  - Format 100% compatible with `.claude/skills/` structure
+  - Installation: `npx add-skill <owner/repo>` → copies to `~/.claude/skills/`
+  - Supported agents: 20+ (Claude Code, Cursor, GitHub Copilot, Windsurf, etc.)
+  - Top skills by category: Frontend (vercel-react, web-design), Database (supabase-postgres), Auth (better-auth), Testing (TDD)
+  - Status documented: Community project (Vercel Labs, not official Anthropic), early stage
+  - Trade-offs: Centralized discovery vs GitHub distribution, multi-agent focus vs Claude Code specific
+  - Cross-reference added to `guide/ai-ecosystem.md` Section 11.3 (Skills Distribution Platforms)
+  - Complementary resources table updated in README.md
+  - YAML index entries:
+    - `skills_marketplace: 5172`
+    - `skills_marketplace_url: https://skills.sh/`
+    - `skills_marketplace_github: vercel-labs/agent-skills`
+    - `skills_marketplace_install: npx add-skill <owner/repo>`
+    - `skills_marketplace_top_skills` (5 entries with install counts)
+    - `skills_marketplace_status: Community (Vercel Labs), launched Jan 21, 2026`
+
 ## [3.11.4] - 2026-01-23
 
 ### Added
diff --git a/README.md b/README.md
index deba04c..ad634e6 100644
--- a/README.md
+++ b/README.md
@@ -361,7 +361,7 @@ Claude Code sends your prompts, file contents, and MCP results to Anthropic serv
 
 **Status**: Research preview (Pro $20/mo or Max $100-200/mo, macOS only, **VPN incompatible**)
 
-**Archive**: Historical versions available in git history (pre-v3.11.4)
+**Archive**: Historical versions available in git history (pre-v3.11.5)
 
 </details>
 
@@ -384,6 +384,7 @@ Claude Code sends your prompts, file contents, and MCP results to Anthropic serv
 | Project | Focus | Best For |
 |---------|-------|----------|
 | [claude-code-templates](https://github.com/davila7/claude-code-templates) | **Distribution** - Install & use | Getting 200+ templates via CLI (17k⭐) |
+| [skills.sh](https://skills.sh/) | **Skills marketplace** - Discover & install | One-command skill installation (`npx add-skill`) from Vercel Labs |
 | [awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code) | **Curation** - Discover & link | Exploring community resources |
 | [Claude-Code-Everything](https://github.com/wesammustafa/Claude-Code-Everything) | **Visual walkthrough** | Learning through screenshots |
 | [AI Coding Agents Matrix](https://coding-agents-matrix.dev) | **Technical comparison** | Comparing Claude Code vs 22+ alternatives |
@@ -430,7 +431,7 @@ Licensed under [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/).
 
 ---
 
-*Version 3.11.4 | January 2026 | Crafted with Claude*
+*Version 3.11.5 | January 2026 | Crafted with Claude*
 
 <!-- SEO Keywords -->
 <!-- claude code, claude code tutorial, anthropic cli, ai coding assistant, claude code mcp,
diff --git a/VERSION b/VERSION
index 0c7d5f5..9ac3804 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-3.11.4
+3.11.5
diff --git a/guide/ai-ecosystem.md b/guide/ai-ecosystem.md
index be05b85..8b74839 100644
--- a/guide/ai-ecosystem.md
+++ b/guide/ai-ecosystem.md
@@ -1281,6 +1281,67 @@ External resources from experienced practitioners that validate and extend the p
 
 ---
 
+## 11.3 Skills Distribution Platforms
+
+For discovering and distributing agent skills beyond local creation:
+
+### skills.sh (Vercel Labs)
+
+**URL**: [skills.sh](https://skills.sh/) | **GitHub**: [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) | **Launched**: January 21, 2026
+
+**What it is**: Centralized marketplace for agent skills with one-command installation. Provides leaderboard, trending view, and 200+ skills from Vercel, Anthropic, Supabase, and community contributors.
+
+**Installation**:
+```bash
+npx add-skill vercel-labs/agent-skills  # React/Next.js (35K+ installs)
+npx add-skill supabase/agent-skills     # Postgres patterns
+npx add-skill anthropics/skills         # Frontend design + skill-creator
+```
+
+**Supported agents**: 20+ including Claude Code, Cursor, GitHub Copilot, Windsurf, Cline, Goose
+
+**Status**: Community project (Vercel Labs), very recent (Jan 2026), rapid adoption but early stage
+
+**Format**: 100% compatible with Claude Code's `.claude/skills/` structure (SKILL.md + YAML frontmatter)
+
+### claude-code-templates (GitHub)
+
+**URL**: [github.com/davila7/claude-code-templates](https://github.com/davila7/claude-code-templates) | **Stars**: 17K+
+
+**What it is**: GitHub-based distribution of full workflows (agents + commands + hooks + skills). Focuses on complete project templates rather than individual skills.
+
+**Installation**: Clone and copy templates manually
+
+**Status**: Established community resource, broader scope than skills.sh (includes entire `.claude/` configurations)
+
+### SkillsMP (Community Index)
+
+**URL**: [skillsmp.com](https://skillsmp.com/)
+
+**What it is**: Community-driven index of 7000+ skills with AI-evaluated rankings (S/A/B/C tiers)
+
+**Focus**: Discovery and cataloging, broader ecosystem than just Claude Code
+
+### When to Use
+
+| Use Case | Platform |
+|----------|----------|
+| Discover popular framework skills | skills.sh (leaderboard) |
+| One-command install official skills | skills.sh (Vercel React, Supabase) |
+| Full workflow templates | claude-code-templates |
+| Team-specific/internal skills | GitHub repos (custom) |
+| Enterprise custom skills | Local `.claude/skills/` |
+
+### Integration with This Guide
+
+See [Section 5.5: Skills Marketplace](./ultimate-guide.md#skills-marketplace-skillssh) for:
+- Detailed installation instructions
+- Top skills by category (Frontend, Database, Auth, Testing)
+- Format compatibility details
+- Trade-offs and recommendations
+
+---
+
 ## 12. Context Packing Tools
 
 When working with LLMs on large codebases, **context packing** refers to techniques for extracting and feeding relevant code context to the model efficiently.
diff --git a/guide/cheatsheet.md b/guide/cheatsheet.md
index eb111f7..bfa3abc 100644
--- a/guide/cheatsheet.md
+++ b/guide/cheatsheet.md
@@ -6,7 +6,7 @@
 
 **Written with**: Claude (Anthropic)
 
-**Version**: 3.11.4 | **Last Updated**: January 2026
+**Version**: 3.11.5 | **Last Updated**: January 2026
 
 ---
 
@@ -424,4 +424,4 @@ where.exe claude; claude doctor; claude mcp list
 
 **Author**: Florian BRUNIAUX | [@Méthode Aristote](https://methode-aristote.fr) | Written with Claude
 
-*Last updated: January 2026 | Version 3.11.4*
+*Last updated: January 2026 | Version 3.11.5*
diff --git a/guide/ultimate-guide.md b/guide/ultimate-guide.md
index f84e4c9..edee917 100644
--- a/guide/ultimate-guide.md
+++ b/guide/ultimate-guide.md
@@ -10,7 +10,7 @@
 
 **Last updated**: January 2026
 
-**Version**: 3.11.4
+**Version**: 3.11.5
 
 ---
 
@@ -5169,6 +5169,95 @@ For comprehensive DevOps/SRE workflows, see **[DevOps & SRE Guide](./devops-sre.
 
 **Quick Start**: [Agent Template](../examples/agents/devops-sre.md) | [CLAUDE.md Template](../examples/claude-md/devops-sre.md)
 
+### Skills Marketplace: skills.sh
+
+**URL**: [skills.sh](https://skills.sh/) | **GitHub**: [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) | **Launched**: January 21, 2026
+
+Skills.sh (Vercel Labs) provides a centralized marketplace for discovering and installing agent skills with one-command installation:
+
+```bash
+npx add-skill vercel-labs/agent-skills  # React/Next.js best practices (35K+ installs)
+npx add-skill supabase/agent-skills     # Postgres optimization patterns
+npx add-skill anthropics/skills         # Frontend design + skill-creator
+```
+
+#### How It Works
+
+**Installation**: Skills are copied to `~/.claude/skills/` (same format as this guide)
+
+**Supported agents**: 20+ including Claude Code, Cursor, GitHub Copilot, Windsurf, Cline, Goose, and others
+
+**Format**: Standard SKILL.md with YAML frontmatter (100% compatible with Section 5.2-5.3)
+
+#### Top Skills by Category (January 2026)
+
+| Category | Top Skills | Installs | Creator |
+|----------|-----------|----------|---------|
+| **Frontend** | vercel-react-best-practices | 35K+ | vercel-labs |
+| | web-design-guidelines | 26.6K | vercel-labs |
+| | frontend-design | 5.6K | anthropics |
+| **Database** | supabase-postgres-best-practices | 1K+ | supabase |
+| **Auth** | better-auth-best-practices | 2K+ | better-auth |
+| **Testing** | test-driven-development | 721 | obra |
+| **Meta** | skill-creator | 3.2K | anthropics |
+
+Full catalog: [skills.sh leaderboard](https://skills.sh/)
+
+#### Status & Trade-offs
+
+**Status**: Very recent (launched Jan 21, 2026), rapid adoption but early stage
+
+**Governance**: Community project by Vercel Labs (not official Anthropic). Skills contributed by Vercel, Anthropic, Supabase, and community members.
+
+**Trade-offs**:
+- ✅ Centralized discovery + leaderboard (200+ skills)
+- ✅ One-command install (vs manual GitHub clone)
+- ✅ Format 100% compatible with this guide
+- ⚠️ Multi-agent focus (not Claude Code specific)
+- ⚠️ Early stage (maturity to prove over time)
+
+#### When to Use
+
+| Use Case | Recommendation |
+|----------|----------------|
+| **Discover popular patterns** | skills.sh (leaderboard, trending) |
+| **Install official framework skills** | skills.sh (Vercel React, Supabase, etc.) |
+| **Team-specific/internal skills** | GitHub repos (like [claude-code-templates](https://github.com/davila7/claude-code-templates), 17K⭐) |
+| **Custom enterprise skills** | Local `.claude/skills/` (Section 5.2-5.3) |
+
+#### Installation Examples
+
+**Standard installation** (global, all Claude Code sessions):
+```bash
+# Install Vercel bundle (3 skills: react + web-design + deploy)
+npx add-skill vercel-labs/agent-skills
+
+# Install Supabase Postgres patterns
+npx add-skill supabase/agent-skills
+
+# Verify installation
+ls ~/.claude/skills/
+# Output: react-best-practices/ web-design-guidelines/ vercel-deploy/
+```
+
+**Manual installation** (project-specific):
+```bash
+# Clone from GitHub
+git clone https://github.com/vercel-labs/agent-skills.git /tmp/agent-skills
+
+# Copy specific skill
+cp -r /tmp/agent-skills/react-best-practices .claude/skills/
+
+# Claude Code auto-discovers skills in .claude/skills/
+```
+
+#### References
+
+- [Vercel Changelog: Introducing Agent Skills](https://vercel.com/changelog/introducing-skills-the-open-agent-skills-ecosystem)
+- [GitHub: vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills)
+- [Platform Claude Docs: Skill Best Practices](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices)
+- See also: [AI Ecosystem Guide](./ai-ecosystem.md) for complementary tools
+
 ---
 
 # 6. Commands
@@ -13989,4 +14078,4 @@ Thumbs.db
 
 **Contributions**: Issues and PRs welcome.
 
-**Last updated**: January 2026 | **Version**: 3.11.4
+**Last updated**: January 2026 | **Version**: 3.11.5
diff --git a/machine-readable/reference.yaml b/machine-readable/reference.yaml
index 2582bf9..c14aadc 100644
--- a/machine-readable/reference.yaml
+++ b/machine-readable/reference.yaml
@@ -3,7 +3,7 @@
 # Source: guide/ultimate-guide.md
 # Purpose: Condensed index for LLMs to quickly answer user questions about Claude Code
 
-version: "3.11.4"
+version: "3.11.5"
 updated: "2026-01-23"
 
 # ════════════════════════════════════════════════════════════════
@@ -108,6 +108,19 @@ deep_dive:
   # Automatic skill generation (meta-skill)
   claudeception: "https://github.com/blader/Claudeception"
   claudeception_guide: 5095
+  # Skills Marketplace (added 2026-01-23)
+  skills_marketplace: 5172
+  skills_marketplace_url: "https://skills.sh/"
+  skills_marketplace_github: "https://github.com/vercel-labs/agent-skills"
+  skills_marketplace_install: "npx add-skill <owner/repo>"
+  skills_marketplace_top_skills:
+    - "vercel-react-best-practices: 35K+ installs"
+    - "web-design-guidelines: 26.6K installs"
+    - "supabase-postgres-best-practices: 1K+ installs"
+    - "better-auth-best-practices: 2K+ installs"
+    - "test-driven-development: 721 installs"
+  skills_marketplace_status: "Community (Vercel Labs), launched Jan 21, 2026"
+  skills_marketplace_changelog: "https://vercel.com/changelog/introducing-skills-the-open-agent-skills-ecosystem"
   # Verification Loops & Eval Harness (added 2026-01-23)
   verification_loops: "guide/methodologies.md:145"
   verification_loops_source: "https://www.anthropic.com/engineering/claude-code-best-practices"
@@ -550,7 +563,7 @@ ecosystem:
       - "Cross-links modified → Update all 4 repos"
     history:
       - date: "2026-01-20"
-        event: "Code Landing sync v3.11.4, 66 templates, cross-links"
+        event: "Code Landing sync v3.11.5, 66 templates, cross-links"
         commit: "5b5ce62"
       - date: "2026-01-20"
         event: "Cowork Landing fix (paths, README, UI badges)"