Claude Skills

A self-hosted Claude Code marketplace for custom skill plugins. Each skill ships as an independent plugin, discoverable and invocable via / slash commands across both the CLI and VS Code extension.

This marketplace is actively maintained. Skills are added and versioned as workflows mature.

• Claude Code (CLI or VS Code extension), authenticated
• Git with GitHub credentials configured

One-time operation. Once registered, every plugin in this repo becomes discoverable.

Option A - CLI:

claude plugins:add-marketplace rs2pydev/claude-skills

Option B - Manual (settings.json):

Add to ~/.claude/settings.json under extraKnownMarketplaces:

{
  "extraKnownMarketplaces": {
    "rs2pydev-claude-skills": {
      "source": {
        "source": "github",
        "repo": "rs2pydev/claude-skills"
      }
    }
  }
}

Add desired plugins to enabledPlugins in the same ~/.claude/settings.json:

{
  "enabledPlugins": {
    "audit-py-codebase@rs2pydev-claude-skills": true,
    "audit-react-vite-tsx-codebase@rs2pydev-claude-skills": true,
    "compress-context@rs2pydev-claude-skills": true
  }
}

• CLI: No restart needed - picks up changes on next invocation.
• VS Code: Full restart required (close all windows, reopen). The extension reads settings.json at session init and caches it.

# Python codebase audit
/audit-py-codebase:audit-py-codebase ./backend

# React/Vite/TSX codebase audit
/audit-react-vite-tsx-codebase:audit-react-vite-tsx-codebase ./frontend

# Compress a context file for token efficiency
/compress-context:compress-context ./CLAUDE.md

The audit skills are designed for iterative re-invocation:

Pass 1: Fixes 40+ issues, scorecard reports "12 remaining"
Pass 2: Fixes 8 issues (including regressions from pass 1 refactors), reports "2 remaining"
Pass 3: Zero new issues found, reports "CONVERGED"

Each pass runs in a fresh context - no accumulated bias. Re-invoke until the scorecard says CONVERGED.

The compress-context skill reads a file, applies symbolic notation rules (operators, abbreviations, structural patterns), rewrites it in-place, and generates a symbols.md legend in the same directory for human reference.

PowerShell script that automates the full publish lifecycle: clone, structure, commit, push, register, enable. Designed for Windows environments where pwsh is the primary shell.

scripts/Manage-LocalPlugin.ps1

# Register a new skill
.\Manage-LocalPlugin.ps1 -Register -Path ".\audit-go-codebase.md" -RepoUrl "https://github.com/rs2pydev/claude-skills.git"

# Register all .md files in a directory (each becomes its own plugin)
.\Manage-LocalPlugin.ps1 -Register -Path ".\skills\" -RepoUrl "https://github.com/rs2pydev/claude-skills.git"

# Update existing (auto-increments patch version)
.\Manage-LocalPlugin.ps1 -Update -Path ".\audit-py-codebase.md" -RepoUrl "https://github.com/rs2pydev/claude-skills.git"

# Explicit version bump
.\Manage-LocalPlugin.ps1 -Update -Path ".\audit-py-codebase.md" -RepoUrl "https://github.com/rs2pydev/claude-skills.git" -Version "2.0.0"

1. Parses .md frontmatter for name, description, version
2. Clones the marketplace repo (or pulls latest if already cloned)
3. Scaffolds plugin structure: <name>/.claude-plugin/plugin.json + skills/<name>/SKILL.md
4. Adds/updates the entry in .claude-plugin/marketplace.json
5. Commits and pushes to GitHub
6. Registers the marketplace in ~/.claude/settings.json (idempotent - first run only)
7. Enables the plugin in enabledPlugins

Input .md files must have YAML frontmatter:

---
name: skill-name
description: "One-line trigger description."
version: 1.0.0
---

# Skill instructions...

If frontmatter is absent, name is derived from filename and a generic description is used.

1. Confirm both extraKnownMarketplaces and enabledPlugins entries exist in ~/.claude/settings.json.
2. Full VS Code restart (not Reload Window).
3. If autocomplete still misses, type the full invocation manually - execution still works.

Corporate proxy/firewall throttling GitHub API calls. The plugins still load and function - only the "Manage Plugins" UI catalog times out. Invoke skills directly via /.

Same settings.json, different read timing. CLI reads fresh per invocation; VS Code caches at session start. A full restart forces re-read.

.claude-plugin/
  marketplace.json                                  # Discovery manifest

audit-py-codebase/
  .claude-plugin/plugin.json
  skills/audit-py-codebase/SKILL.md

audit-react-vite-tsx-codebase/
  .claude-plugin/plugin.json
  skills/audit-react-vite-tsx-codebase/SKILL.md

compress-context/
  .claude-plugin/plugin.json
  skills/compress-context/SKILL.md

scripts/
  Manage-LocalPlugin.ps1                            # PowerShell publish automation

.\scripts\Manage-LocalPlugin.ps1 -Register -Path ".\my-skill.md" -RepoUrl "https://github.com/rs2pydev/claude-skills.git"

1. Create <skill-name>/ at repo root
2. Add .claude-plugin/plugin.json:

   {
     "name": "<skill-name>",
     "version": "1.0.0",
     "description": "One-line description.",
     "author": { "name": "rs2pydev" }
   }

3. Add skills/<skill-name>/SKILL.md with frontmatter:

   ---
   name: <skill-name>
   description: "Trigger description for Claude Code skill discovery."
   version: 1.0.0
   ---

4. Register in .claude-plugin/marketplace.json under plugins[]
5. Commit, push, restart Claude Code.

MIT