bateau84/skills

python-common-practice

Python verification, code-quality posture, and skill-family conventions.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/bateau84/skills --skill python-common-practice

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

Python Common Practice

The Python-specific base layer for the python-* skill family.

Scope

This skill provides engineering guidance for any agent. Follow the user's task, repository conventions, and host permissions; no role hierarchy or orchestration framework is assumed.

Use it only to improve the quality and verification of already-authorized Python work.

Inner verification loop

Use the repository's configured tools. A common baseline is:

bash
uv sync
uv run ruff check .
uv run ruff format --check .
uv run pytest
uv run mypy .   # or pyright / ty when configured

Do not assume every project uses every tool. Read pyproject.toml and current repository guidance first.

A domain skill may require stronger checks such as coverage, async tests, security scanning, or profiling. Treat those as verification expectations when relevant.

When conclusions rely on verification, record the commands, scope, and observed outcomes in the task summary or the project's verification record. Distinguish unrun checks and limitations from passing results.

Diagnose before fixing

Reproduce and inspect failures before editing. Use focused tests, traceback inspection, debugger/profiler output, type-checker output, or runtime instrumentation as appropriate. Change one causal factor, then re-run the focused check.

Dependency posture

Prefer the standard library when it is sufficient. New runtime dependencies are a maintenance commitment and should be justified by the task and accepted architecture.

Use the project's actual package manager. Prefer uv only when the repository already uses it or the authorized task includes adopting it.

Strictness posture

Generic Python guidance never overrides accepted repository authority. When framework convention and accepted architecture differ, current authority wins and the trade-off should be explicit.

Cross-reference style

Sibling skills are referenced by bare local name such as python-testing, python-fastapi, or python-error-handling.

Load the smallest useful set rather than the entire Python family.

관련 작업

같은 저장소의 Skills

더 많은 Skills

모든 Skills
bateau84
커뮤니티

behavioral-spec

Derive bounded, implementation-independent requirements from agreed product intent through goal refinement, coverage lenses, obstacle analysis, provenance tracking, and counterexample checks. Use to select, author, and reconcile Behavioral Requirements (BR), Quality Scenarios (QS), and Obligation Contracts (OC) without expanding scope. Not for concrete API/schema/protocol realization (use architectural-spec) or human-centered stories and scenarios (use user-stories-and-scenarios).

1시간 설치 수
1
GitHub Stars
0
업데이트
10월 18일
bateau84
커뮤니티

desktop-ui-design

Desktop GUI design for native and hybrid applications: platform conventions (macOS HIG, Windows Fluent, GNOME HIG), menus, keyboard shortcuts, window management, session persistence, native vs Electron/Tauri trade-offs, and accessibility APIs. Use for Swift/AppKit, C/WinUI, GTK+, or Electron/Tauri/Flutter desktop design. Add web-ui-design for a web app shipped as a desktop wrapper. Not for browser-only interfaces, terminal applications (use tui-design), or command-line tools (use cli-design).

1시간 설치 수
1
GitHub Stars
0
업데이트
10월 18일
bateau84
커뮤니티

git-commit-discipline

Small coherent commits, explanatory messages, shared-working-tree discipline, and safe undo/recovery. Use when asked to commit, when a diff mixes concerns, when agents share a working tree, or when undoing or recovering Git changes. Not for content conflicts (use git-conflicts).

1시간 설치 수
1
GitHub Stars
0
업데이트
10월 18일
bateau84
커뮤니티

golang-dependency-injection

google/wire, uber-go/dig, uber-go/fx, samber/do, manual constructor injection, and service containers in Go. Use when designing service architecture, setting up dependency injection, refactoring tightly coupled code, or managing singletons and service factories.

1시간 설치 수
1
GitHub Stars
0
업데이트
10월 18일