mvolkov-skills

A Claude Code plugin marketplace bundling production-tested best-practices skills for an async-first Python backend stack — SQLAlchemy 2.0, FastAPI, pytest, gRPC (grpc.aio), git workflow, and OpenTelemetry observability.

If you're using Claude Code on Python projects with this stack, these skills make Claude consistent with conventions the team has already converged on, without bloating your context. Each skill lazy-loads only when relevant — no cost on conversations where it doesn't apply.

What's inside

6 standalone skills. Install only what you need:

Plugin	Triggers on	Adds guidance for
`sqlalchemy-best-practices`	imports of `sqlalchemy` / `sqlalchemy.ext.asyncio`, `AsyncSession`, `Mapped[T]`, `select()`, `selectinload`, ORM models, `MissingGreenlet` errors	SQLAlchemy 2.0 async — engine/pool defaults, `Mapped[T]` model design, relationship loading strategies, async session lifecycle, FastAPI DI
`fastapi-best-practices`	imports of `fastapi` / `pydantic_settings`, `APIRouter`, `Depends`, `BackgroundTasks`, `BaseSettings`, Pydantic v2 schemas	FastAPI production — domain-organized structure, async correctness, DI patterns with per-request caching, split request/response models, Settings v2 with `lru_cache`, async testing
`pytest-best-practices`	code under `tests/`, `@pytest.fixture`, `@pytest.mark.asyncio`, `parametrize`, imports of `pytest_asyncio` / `factory` / `faker` / `respx` / `freezegun` / `hypothesis`	pytest async-first — fixture scope discipline, `pytest-asyncio` with `asyncio_mode=auto`, factory_boy + faker test data, respx HTTP mocks, real-DB integration via testcontainers, `flush()` pattern, `pytest-xdist` parallelism
`grpc-python-best-practices`	`grpc.aio.`, `_pb2.py` / `*_pb2_grpc.py` files, `.proto` files, `ServerInterceptor`, `UnaryUnaryClientInterceptor`	gRPC `grpc.aio` Kubernetes-native — server bootstrap with health-drain, shared channel factory, decorator pattern (`@grpc_logger` + `@grpc_error_handler`), `max_connection_age_*` for HPA rebalancing, client-side LB via `dns:///` + `round_robin`, ERROR_MAP with rich `google.rpc.Status`
`git-workflow-best-practices`	`git commit`, `git push`, `gh pr create`, branch creation, PR review prep, commit message writing	Git Flow branches, Conventional Commits, atomic commits with imperative mood, pre-commit hygiene, `pull --rebase`, force-push scope, ~400 LOC PR target, squash on merge
`observability-best-practices`	imports of `opentelemetry.*`, `setup_telemetry()` calls, `tracer.start_as_current_span()`, `LoggingInstrumentor`, span attribute setting, structlog with `trace_id` binding, OTLP exporter config, Loki / Tempo / Grafana / Sentry integration	Python OpenTelemetry — SDK bootstrap with off-switch + idempotency guard, auto-instrumentation (gRPC / SQLAlchemy / FastAPI / Logging), `LoggingInstrumentor` + structlog correlation, two-tier log field taxonomy, `<service>.<key>` span attributes, sensitive-field redaction, metrics cardinality control, tail-based sampling, Sentry-with-OTel

Each skill is depersonalized — generic placeholder names (MyService, MyServiceClient, MyServiceError) instead of project-specific symbols. Patterns are anchored in real production code but written to apply across any project that follows the same stack.

Quick start

In any Claude Code session:

/plugin marketplace add mvolkov83/skills
/plugin install sqlalchemy-best-practices@mvolkov-skills
/plugin install fastapi-best-practices@mvolkov-skills
/plugin install pytest-best-practices@mvolkov-skills
/plugin install grpc-python-best-practices@mvolkov-skills
/plugin install git-workflow-best-practices@mvolkov-skills
/plugin install observability-best-practices@mvolkov-skills
/reload-plugins

That's it. Run a SQLAlchemy / FastAPI / pytest / gRPC / OTel question and the relevant skill auto-triggers.

Heads up on the alias: the install alias (@mvolkov-skills) is the name field from .claude-plugin/marketplace.json — not the basename of the repo URL. Claude Code reports the actual alias after /plugin marketplace add ("Successfully added marketplace: <alias>"); use exactly that. If you see "marketplace not found" on install, double-check the alias from that line.

sqlalchemy-best-practices

Popularity

What's Inside

README

mvolkov-skills

What's inside

Quick start

What is a "skill"?

Confidence

Similar Plugins

fullstack-dev-skills

nature-skills

drawio-diagramming

planning-with-files

creative-writing

payload

More by mvolkov83

pytest-best-practices

fastapi-best-practices

grpc-python-best-practices

git-workflow-best-practices

observability-best-practices