Metadata-Version: 2.4
Name: skilldex
Version: 0.1.0
Summary: Search, install, validate, and audit Claude Code skills, subagents, and MCP servers from a community registry.
Project-URL: Homepage, https://github.com/drewn-ed/skilldex
Project-URL: Registry, https://github.com/drewn-ed/skilldex-registry
Author-email: David Cecko <ceckodavid@gmail.com>
License: MIT
License-File: LICENSE
Keywords: claude,claude-code,cli,mcp,registry,skills,subagents
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.0
Requires-Dist: typer>=0.12
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.6; extra == 'dev'
Description-Content-Type: text/markdown

# skilldex

[![CI](https://github.com/drewn-ed/skilldex/actions/workflows/ci.yml/badge.svg)](https://github.com/drewn-ed/skilldex/actions/workflows/ci.yml)

**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:

```bash
# no install needed
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](https://github.com/drewn-ed/skilldex-registry) — every entry is CI-validated before it's merged. Browse it in your browser at [drewn-ed.github.io/skilldex-registry](https://drewn-ed.github.io/skilldex-registry/).

## Install

```bash
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 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](https://github.com/drewn-ed/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

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

MIT licensed. Not affiliated with Anthropic.
