Communitygithub.com

cdcoonce/Portfolio_Website

프로덕션 파이썬 코딩 표준 (자동 버전 감지 3.10-3.13). 파이썬 코드 작성, 리뷰, 리팩토링 시 현대적 타입 문법, LBYL 예외 처리, pathlib 연산, ABC 기반 인터페이스, 프로덕션 테스트 패턴을 준수하도록 할 때 사용합니다. Dagster 특화가 아닌 모든 파이썬 프로젝트에 적용됩니다.

Portfolio_Website란 무엇인가요?

이 스킬은 프로덕션 수준의 파이썬 코딩 표준을 제공하여 깔끔하고 유지보수 가능한 현대적인 파이썬 코드(버전 3.10-3.13)를 작성하도록 돕습니다. 주로 코드 리뷰, 타입 힌트, LBYL vs EAFP 예외 처리, pathlib vs os.path 경로 연산, CLI 패턴, 전반적인 파이썬 코드 품질 향상에 사용됩니다. 자동 버전 감지 기능이 있어 프로젝트의 최소 파이썬 버전을 pyproject.toml, setup.py 등에서 식별하고 해당 버전에 맞는 최적의 가이드를 로드합니다. 핵심 지식은 항상 로드되며, 특정 패턴(예: click, subprocess)이 감지되면 보조 참조 문서가 조건부로 로드됩니다. 이 스킬은 특정 프레임워크(Dagster 등)가 아닌 일반 파이썬 표준에 초점을 맞추므로 모든 파이썬 프로젝트에서 유용합니다. 참조 문서는 핵심 표준, 버전별 기능, 고급 주제(예외 처리, 인터페이스, 고급 타입, API 설계)로 구성되어 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cdcoonce/Portfolio_Website/tree/HEAD/.claude/skills/dignified-python

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

품위 있는 파이썬 코딩 표준 스킬

깔끔하고 유지보수 가능한 현대적 파이썬 코드(버전 3.10-3.13)를 작성하기 위한 프로덕션 품질의 파이썬 코딩 표준입니다.

이 스킬을 사용해야 할 때

사용자가 다음과 같은 내용을 요청할 때 자동 호출됩니다:

  • "파이썬스럽게 만들어 줘" / "이 파이썬 코드 괜찮아?"
  • "타입 힌트" / "타입 어노테이션" / "타이핑"
  • "LBYL vs EAFP" / "예외 처리"
  • "pathlib vs os.path" / "경로 연산"
  • "CLI 패턴" / "click 사용법"
  • "코드 리뷰" / "이 코드 개선해 줘"
  • 모든 파이썬 코드 품질 또는 표준 관련 질문

참고: 이 스킬은 일반 파이썬 표준이며, Dagster 특화가 아닙니다. Dagster 패턴은 /dagster-expert를 사용하세요.

이 스킬과 다른 스킬을 사용해야 할 때

사용자 요구사항이 스킬 사용대체 스킬
"파이썬스럽게 만들어 줘"✅ 예 - 파이썬 표준
"이 파이썬 코드 괜찮아?"✅ 예 - 코드 품질
"타입 힌트"✅ 예 - 타입 가이드
"LBYL vs EAFP"✅ 예 - 예외 패턴
"pathlib vs os.path"✅ 예 - 경로 처리
"Dagster 관련 패턴"❌ 아니요/dagster-expert
"CLI 인자 파싱"✅ 예 - CLI 패턴

핵심 지식 (항상 로드됨)

dignified-python-core.md

버전 감지

프로젝트의 최소 파이썬 버전을 식별하려면 (순서대로 확인):

  1. pyproject.toml - requires-python 필드 확인 (예: requires-python = ">=3.12")
  2. setup.py 또는 setup.cfg - python_requires 확인
  3. .python-version 파일 - 3.12 또는 3.12.0과 같은 버전 포함
  4. 버전 지정자가 없으면 파이썬 3.12를 기본값으로 사용

식별 후, 해당 버전별 파일을 로드:

  • 파이썬 3.10: versions/python-3.10.md 로드
  • 파이썬 3.11: versions/python-3.11.md 로드
  • 파이썬 3.12: versions/python-3.12.md 로드
  • 파이썬 3.13: versions/python-3.13.md 로드

조건부 로딩 (작업 패턴 기반 로드)

핵심 파일은 파이썬 코드 패턴의 80% 이상을 다룹니다. 특정 패턴을 감지했을 때만 다음 추가 파일을 로드하세요:

패턴 감지 예시:

  • 작업에 "click" 또는 "CLI"가 언급된 경우 -> cli-patterns.md 로드
  • 작업에 "subprocess"가 언급된 경우 -> subprocess.md 로드

참조 문서 구조

참조 문서는 최상위 파일과 하위 디렉토리로 구성되어 있습니다:

핵심 참조 (SKILL.md와 동일한 위치)

  • dignified-python-core.md - 필수 표준 (항상 로드됨)
  • cli-patterns.md - 명령줄 인터페이스 패턴 (click, argparse)
  • subprocess.md - 서브프로세스 연산

버전별 참조 (versions/)

  • versions/python-3.10.md - 파이썬 3.10+에서 사용 가능한 기능
  • versions/python-3.11.md - 파이썬 3.11+에서 사용 가능한 기능
  • versions/python-3.12.md - 파이썬 3.12+에서 사용 가능한 기능
  • versions/python-3.13.md - 파이썬 3.13+에서 사용 가능한 기능

고급 주제 (references/advanced/)

  • exception-handling.md - LBYL 패턴, 오류 경계
  • interfaces.md - ABC 및 Protocol 패턴
  • typing-advanced.md - 고급 타입 패턴
  • api-design.md - API 설계 원칙

각 참조 문서를 읽어야 할 때

references/advanced/exception-handling.md

다음 경우에 읽으세요:

  • try/except 블록 작성 시
  • 예외를 발생시킬 수 있는 타사 API 래핑 시
  • from e 또는 from None을 보거나 작성할 때
  • LBYL 대안이 있는지 확실하지 않을 때

references/advanced/interfaces.md

다음 경우에 읽으세요:

  • ABC 또는 Protocol 클래스 생성 시
  • @abstractmethod 데코레이터 작성 시
  • 게이트웨이 계층 인터페이스 설계 시
  • ABC와 Protocol 중 선택해야 할 때

references/advanced/typing-advanced.md

다음 경우에 읽으세요:

  • typing.cast() 사용 시
  • Literal 타입 별칭 생성 시
  • 조건부 블록에서 타입 좁히기 시

references/module-design.md

다음 경우에 읽으세요:

  • 새 파이썬 모듈 생성 시
  • 모듈 수준 코드 추가 시 (단순 상수 제외)
  • 모듈 수준에서 @cache 데코레이터 사용 시
  • 모듈 수준에서 Path() 또는 계산을 볼 때
  • 인라인 임포트 고려 시

references/api-design.md

다음 경우에 읽으세요:

  • 함수에 기본 매개변수 값 추가 시
  • 5개 이상의 매개변수가 있는 함수 정의 시
  • ThreadPoolExecutor.submit() 사용 시
  • 함수 시그니처 리뷰 시

references/checklists.md

다음 경우에 읽으세요:

  • 파이썬 코드 커밋 전 최종 리뷰 시
  • 모든 규칙을 따랐는지 확실하지 않을 때
  • 요구사항을 빠르게 확인해야 할 때

이 스킬 사용 방법

  1. 핵심 지식이 자동으로 로드됩니다 (LBYL, pathlib, 기본 임포트, 안티패턴)
  2. 버전 감지는 한 번 수행됩니다 - 최소 파이썬 버전을 식별하고 해당 버전 파일을 로드합니다
  3. 참조 문서는 위의 트리거를 기반으로 필요 시 로드됩니다
  4. 추가 패턴은 추가 로딩이 필요할 수 있습니다 (CLI 패턴, 서브프로세스)
  5. 각 파일은 독립적이며 해당 도메인에 대한 완전한 지침을 제공합니다

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

cdcoonce/Portfolio_Website

Git commit workflow with enforced conventional commit style. Use when Claude needs to stage and commit changes, craft commit messages, or the user asks to commit, make a commit, or save their work. Ensures consistent commit message format, proper scoping, and atomic commits across the project.

cdcoonce/Portfolio_Website

AI-powered code quality analysis for Python, Markdown, and Mermaid diagrams. Use this skill when: (1) reviewing code for quality issues, (2) checking Python files for PEP8 violations, unused code, missing type hints, docstring problems, complexity issues, or potential runtime errors, (3) validating Markdown documentation for broken links, heading structure, or formatting issues, (4) validating Mermaid diagram syntax, (5) the user asks for a "code review" or "quality check", (6) analyzing code snippets pasted in conversation, or (7) suggesting and applying fixes for code quality issues.

cdcoonce/Portfolio_Website

Deploy the portfolio chat agent Lambda function to AWS. Use when the user asks to deploy, redeploy, push to Lambda, update the chat agent, or after updating context files or lambda_function.py. Rebuilds the knowledge base, packages dependencies, and deploys to AWS Lambda.

cdcoonce/Portfolio_Website

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

cdcoonce/Portfolio_Website

Orchestrate the full GitHub-issues-driven development lifecycle. 7-phase pipeline from brainstorm through PR with state tracking and cross-conversation resume. Use when user says "dev cycle", "development workflow", "full development pipeline", or invokes /dev-cycle.

cdcoonce/Portfolio_Website

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

cdcoonce/Portfolio_Website

GitHub CLI (gh) integration for managing issues, pull requests, branches,

cdcoonce/Portfolio_Website

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

cdcoonce/Portfolio_Website

Explore a codebase to find opportunities for architectural improvement, focusing on making the codebase more testable by deepening shallow modules. Use when user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more AI-navigable.

cdcoonce/Portfolio_Website

CEO/founder-mode plan review. Rethink the problem, find the 10-star product, challenge premises, expand scope when it creates a better product. Three modes: SCOPE EXPANSION (dream big), HOLD SCOPE (maximum rigor), SCOPE REDUCTION (strip to essentials). Use when the user asks for a plan review, CEO review, mega review, or wants a plan challenged/stress-tested before implementation.

cdcoonce/Portfolio_Website

Break a PRD into independently-grabbable GitHub issues using tracer-bullet vertical slices. Use when user wants to convert a PRD to issues, create implementation tickets, or break down a PRD into work items.

cdcoonce/Portfolio_Website

Turn a PRD into a multi-phase implementation plan using tracer-bullet vertical slices, saved as a local Markdown file in docs/plans/. Use when user wants to break down a PRD, create an implementation plan, plan phases from a PRD, or mentions "tracer bullets".

cdcoonce/Portfolio_Website

Generate or update the `.claude/docs/project.md` file that gives Claude project-specific context. Use this skill when the user asks to create, update, regenerate, or refresh project context, or says things like "update project.md", "generate project context", "this repo needs a project.md", or "Claude doesn't know about this project". Also trigger when onboarding Claude to a new repository for the first time.

cdcoonce/Portfolio_Website

Generate comprehensive, high-quality README.md files for code repositories. Use this skill whenever the user asks to create, write, generate, update, or improve a README for any project or repository. Also trigger when the user says things like "document this project", "write docs for this repo", "this repo needs a README", "help me onboard developers to this codebase", or asks for project documentation in markdown. Even if the user just says "README" or "readme" in the context of a codebase, use this skill.

cdcoonce/Portfolio_Website

Create a detailed refactor plan with tiny commits via user interview, then file it as a GitHub issue. Use when user wants to plan a refactor, create a refactoring RFC, or break a refactor into safe incremental steps.

cdcoonce/Portfolio_Website

Set up pre-commit hooks for the current repo. Use when user wants to add pre-commit hooks, configure commit-time linting, formatting, type checking, or testing. Triggers on "pre-commit", "git hooks", "linting hooks", or /setup-pre-commit.

cdcoonce/Portfolio_Website

Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.

cdcoonce/Portfolio_Website

Triage a bug or issue by exploring the codebase to find root cause, then create a GitHub issue with a TDD-based fix plan. Use when user reports a bug, wants to file an issue, mentions "triage", or wants to investigate and plan a fix for a problem.

cdcoonce/Portfolio_Website

Rewrites the prose sections of wiki pages in-place. Reads source files to understand current context, then updates only the content inside <!-- claude:prose --> ... <!-- claude:prose:end --> markers. Never touches <!-- generated:start --> ... <!-- generated:end --> blocks. Supports targeting a single page with /update-wiki {PageName}.

cdcoonce/Portfolio_Website

Create a PRD through user interview, codebase exploration, and module design, then submit as a GitHub issue. Use when user wants to write a PRD, create a product requirements document, or plan a new feature.

관련 스킬