Skip to main content

skilldex

CI PyPI Downloads

Search, install, validate, and audit Claude Code skills, subagents, and MCP servers — from one community registry.

Claude Code extensions live scattered across hundreds of repos. skilldex gives you a package-manager-style workflow for all three extension types:

# no install needed (uvx ships with uv — brew install uv)
uvx skilldex search pdf
uvx skilldex install pdf              # → ~/.claude/skills/pdf
uvx skilldex install fetch            # MCP server → ./.mcp.json
uvx skilldex install code-reviewer -p # subagent → ./.claude/agents (project scope)

Entries come from the community-maintained skilldex-registry — every entry is CI-validated before it's merged. Browse it in your browser at skilldex-hub.github.io.

Install

pip install skilldex        # or: uv tool install skilldex

Commands

Command What it does
skilldex search <query> [-t skill|agent|mcp] Search the registry
skilldex show <id> Full registry entry as JSON
skilldex install <id> [--project] Install a skill/agent (user or project scope) or add an MCP server to .mcp.json
skilldex install <id> --global MCP servers: register user-wide, available in every session
skilldex list Everything installed locally
skilldex validate <path> Lint a SKILL.md, subagent .md, or registry entry .json
skilldex audit Scan local Claude Code config for problems (broken frontmatter, plaintext secrets in .mcp.json, …)

Why validate/audit?

  • A skill with a bad description silently never triggers — validate catches the common frontmatter mistakes before you wonder why.
  • .mcp.json is usually committed to git; audit flags API keys pasted where a ${VAR} placeholder belongs.

Registry

Want your skill, subagent, or MCP server listed? Open a PR adding one JSON file to skilldex-registry — CI validates it automatically, and skilldex validate runs the same checks locally.

Point the CLI at a different (or local) index with SKILLDEX_REGISTRY_URL.

Development

pip install -e ".[dev]"
pytest
ruff check .

MIT licensed. Not affiliated with Anthropic.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

skilldex-0.1.1.tar.gz (13.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

skilldex-0.1.1-py3-none-any.whl (13.2 kB view details)

Uploaded Python 3

File details

Details for the file skilldex-0.1.1.tar.gz.

File metadata

  • Download URL: skilldex-0.1.1.tar.gz
  • Upload date:
  • Size: 13.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for skilldex-0.1.1.tar.gz
Algorithm Hash digest
SHA256 4fe3886d6481f47cd571b4d3cfa4ee8d716554330011a04ca1d3f8c5fb57e556
MD5 29d02c085f6e4c82f0d11783a5daa272
BLAKE2b-256 9b2c7d0d5f01923122b84b45f77432c7bc2ee2129f60ddfca3281a27d912bb66

See more details on using hashes here.

Provenance

The following attestation bundles were made for skilldex-0.1.1.tar.gz:

Publisher: publish.yml on skilldex-hub/skilldex

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file skilldex-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: skilldex-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 13.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for skilldex-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 46cbc62494684a6f9a319c36b3e4af4c0624ef19f0b845e98373420dab1a20ad
MD5 2c47e95a2a473aba65a4b9dd838e16b9
BLAKE2b-256 6a972d20d1e15c4beb67f9b689b08245c37a4dcadb9946d4726e9f64888edfc0

See more details on using hashes here.

Provenance

The following attestation bundles were made for skilldex-0.1.1-py3-none-any.whl:

Publisher: publish.yml on skilldex-hub/skilldex

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page