brian-claude-skills

Use when writing or improving code documentation. Covers docstrings (Google style), README files, API documentation, architecture decision records, and inline comments. Triggers on documentation requests, docstring generation, README creation, or when code needs explanation.

Use when committing code changes. Covers conventional commit format, commit structure, best practices, and pre-commit validation. Triggers on commit requests, git add/commit operations, or when reviewing changes before committing.

Use when creating pull requests. Covers PR structure, GitHub CLI usage, branch workflow, and pre-PR validation. Triggers on PR creation, branch merging, or when preparing changes for review.

Use when creating or editing marimo reactive Python notebooks. Covers cell structure, UI elements (mo.ui), reactivity, SQL integration, markdown, and deployment as apps. Triggers on .py notebook creation, marimo edit/run commands, reactive notebook development, or interactive data exploration. Extends python-development skill.

Use when building Python web APIs, database-backed applications, or backend services. Covers FastAPI, SQLAlchemy (async), PostgreSQL, Alembic migrations, and performance patterns. Triggers on API endpoint creation, database models, query optimization, or migration planning. Extends python-development skill.

Core Python development skill for scripts, utilities, and general Python code. Covers uv package management, script dependencies, project setup, and coding standards. Use for Python file creation, running scripts, dependency management, or general Python tasks. For web APIs and servers, see python-backend skill. For testing, see python-testing skill.

Use when writing or running Python tests with pytest. Covers fixtures, mocking, parametrization, freezegun for time, and async testing. Triggers on test file creation, fixture design, mocking external dependencies, or test suite architecture. Extends python-development skill.

Use when writing, reviewing, or optimizing SQL queries. Covers PostgreSQL syntax, query patterns, schema design, indexing, and performance tuning. Triggers on SQL file creation, query optimization, schema migrations, or database design. For Python ORM usage, see python-backend skill.