Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

general-python

/general-python

Podpowiada standardy pracy w Pythonie: uv, ruff, ty, typowanie, dataclasses i testy pytest w projektach na tym stacku.

Repozytorium
pyref ↗
Licencja
LGPL
Ostatnia zmiana repozytorium
17.10.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
8
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
5
Przestarzałość

Brak sygnałów. Repozytorium zmienione 17.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

LGPL, otwarta.

Co robi i kiedy

Podpowiada standardy pracy w Pythonie: uv, ruff, ty, typowanie, dataclasses i testy pytest w projektach na tym stacku.

Oryginalny opis (EN)

Python stack hub: uv/ruff/ty workflows, builtins and collections, functions and classes, dataclasses, typing boundaries, pytest and NumPy-style docs. Use for any Python task in repos that follow this stack; pairs with python-reviewer, python-types, and python-refactor. Related skills: numpy-scientific, dataframes, numpy-docstrings, matplotlib-scientific, lab-instrumentation. Triggers on Python, uv, ruff, ty, pytest, dataclass, typing.

Jak działa

  1. Synergy map
  2. Quick decisions
  3. Reference index
  4. External anchors
  5. Modern practice snapshot
Sekcje z nagłówków SKILL.md, w oryginale · 50 linii, 408 słów
Podgląd SKILL.md
---
author: dotagents
name: general-python
description: Python stack hub: uv/ruff/ty workflows, builtins and collections, functions and classes, dataclasses, typing boundaries, pytest and NumPy-style docs. Use for any Python task in repos that follow this stack; pairs with python-reviewer, python-types, and python-refactor. Related skills: numpy-scientific, dataframes, numpy-docstrings, matplotlib-scientific, lab-instrumentation. Triggers on Python, uv, ruff, ty, pytest, dataclass, typing.
---

# General Python

This skill is the **hub** for conventions that come from the project **Python** section (often merged into **AGENTS.md**), the **Python Cursor rule** on `**/*.py`, and the **python-reviewer** / **python-types** / **python-refactor** subagents. Load topic files below instead of drifting from project defaults.

## Synergy map

| Source | Role |
|--------|------|
| **Python spec** (AGENTS.md block) | Canonical tooling (uv, ruff, ty), style, pytest, numerics, tables, instruments |
| **Python rule** | Globs `**/*.py`: 3.12+, uv, NumPy-style public docstrings, pyvisa split |
| **python-reviewer** | Post-change review: uv hygiene, typing, numerics footguns, tests |
| **python-types** | Deep typing for Astral **ty**, PEP 695, exhaustive `match` |
| **python-refactor** | Structure: tuples vs dataclasses, composition vs inheritance, size |
| **matplotlib-scientific** | Figures only; keep plotting out of this hub |
| **numpy-scientific** | `ndarray` design: dtypes, views, broadcasting, ufuncs, `linalg`, I/O, random |
| **dataframes** | pandas + Polars: tables, lazy frames, joins, I/O, interop |
| **numpy-docstrings** | numpydoc sections for public API docstrings |
| **lab-instrumentation** | PyVISA, sockets, HALs, validation, PDF datasheets, instrument tests |

## Quick decisions

1. **Dependencies**: `uv add` / `uv remove` / `uv sync` / `uv run`. Never hand-edit version pins in `pyproject.toml`. See [reference-tooling.md](references/reference-tooling.md).
2. **Quality gate**: `ruff check` (and format per project config), then **`ty check`** on touched code. See [reference-tooling.md](references/reference-tooling.md).
3. **Data**: prefer the right **builtin or collections ABC** before a custom class; use **dataclasses** for labeled bundles of data. See [reference-data-structures.md](references/reference-data-structures.md) and [reference-classes-dataclasses.md](references/reference-classes-dataclasses.md).
4. **APIs**: small **pure** core, **I/O at edges**, explicit types on public boundaries. See [reference-functions.md](references/reference-functions.md) and [reference-types-and-agents.md](references/reference-types-and-agents.md).
5. **Tests and docs**: `uv run pytest`; **NumPy-style docstrings** on public APIs. See [reference-testing-docs.md](references/reference-testing-docs.md).

## Reference index

| Topic | File |
|--------|------|
| uv, ruff, ty, layout, CI-style verification | [reference-tooling.md](references/reference-tooling.md) |
| list, dict, tuple, set, comprehensions, `collections` | [reference-data-structures.md](references/reference-data-structures.md) |
| Functions: purity, parameters, errors, resources | [reference-functions.md](references/reference-functions.md) |
| Classes, dataclasses, slots, immutability | [reference-classes-dataclasses.md](references/reference-classes-dataclasses.md) |
| Types, ty, when to delegate to **python-types** | [reference-types-and-agents.md](references/reference-types-and-agents.md) |
| pytest, docstrings, readability | [reference-testing-docs.md](references/reference-testing-docs.md) |
| Vectorized numerics, tables, instruments, plotting boundary | [reference-scientific-numerics.md](references/reference-scientific-numerics.md) |

## External anchors

- [uv](https://docs.astral.sh/uv/latest/), [Ruff](https://docs.astral.sh/ruff/), [ty](https://docs.astral.sh/ty/) (Astral)
- [PEP 8](https://peps.python.org/pep-0008/) style surface; project **ruff** rules are authoritative
- [Python data model](https://docs.python.org/3/reference/datamodel.html) for dunder semantics

## Modern practice snapshot

Reproducible projects combine **locked deps**, **fast lint/format**, and **static typing** on API surfaces; **src layout** avoids import ambiguity; automate checks in CI or pre-commit. See [reference-tooling.md](references/reference-tooling.md).
Pliki w paczce (8)
  • SKILL.md 4 KB
  • references/reference-classes-dataclasses.md 2 KB
  • references/reference-data-structures.md 2 KB
  • references/reference-functions.md 2 KB
  • references/reference-scientific-numerics.md 1 KB
  • references/reference-testing-docs.md 1 KB
  • references/reference-tooling.md 2 KB
  • references/reference-types-and-agents.md 2 KB

Wersje

W bazie nie ma innych skilli o nazwie general-python.

Migawka bazy z 13.11.2026 · wersja paczki 5faaa2d87510 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100rc-python
    Wspiera idiomatyczny, typowany Python 3.12+ z asyncio, dataclasses, pytest, ruff i uv przy pisaniu oraz przeglądzie kodu.
  • 90dev-python-quality
    Sprawdza jakość kodu w Pythonie: typowanie, asynchroniczność, pakowanie, pytest, ruff i mypy.
  • 90modern-python
    Tworzy lub migruje projekt albo skrypt w Pythonie do uv, Ruff, ty i pytest.
  • 100python-standards
    Określa standardy kodu Python 3.11+: typowanie, ruff, mypy, uv, pytest, async, Docker oraz konwencje FastAPI i Django.
  • 100python-helper
    Podaje aktualne wskazówki dla Python: wersje, uv i pip, pakowanie, typowanie, asyncio, pytest, Ruff, bezpieczeństwo, granice uruchomieniowe, pyproject.toml, CI i aktualizacje.
  • 90python-fastapi
    Buduje i przegląda usługi w Pythonie na FastAPI, Pydantic v2 i asynchronicznym SQLAlchemy, z typowaniem, uv, ruff i pytest.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.