📋

Cc Plugin Catalog CLAUDE.md

Static site generator for Claude Code Plugin Marketplace repositories

by @giginet

Sourced from giginet/cc-plugin-catalog — Apache-2.0

CLAUDE.md

> Sourced from [giginet/cc-plugin-catalog](https://github.com/giginet/cc-plugin-catalog) — [Apache-2.0](https://github.com/giginet/cc-plugin-catalog/blob/406ac1c0918fd6612ec346de81447993afc74439/CLAUDE.md).

# cc-plugin-catalog

Static site generator for Claude Code Plugin Marketplace repositories.

- Spec: https://code.claude.com/docs/en/plugin-marketplaces
- Official marketplace: https://github.com/anthropics/claude-plugins-official

Use the official marketplace repo and docs as reference when developing.

## Stack

- Python 3.12, managed with uv
- CLI: Click
- Templates: Jinja2
- Models: Pydantic
- Markdown: python-markdown

## Commands

```bash
uv run pytest tests/ -v      # Tests
uv run ruff check src/ tests/ # Lint
uv run ruff format src/ tests/ # Format
uv run ty check src/          # Type check
```

## CI/CD

- `ci.yml`: pytest, ruff, ty
- `build-pages.yml`: Reusable workflow for marketplace repos
- `publish.yml`: PyPI publish on GitHub Release (Trusted Publisher)

## Release

- Tag format: `X.Y.Z` (no `v` prefix, e.g. `1.0.0`)
- Update version in both `pyproject.toml` and `src/cc_plugin_catalog/__init__.py`
- Create a GitHub Release with the tag to trigger PyPI publish