Communitygithub.com

cdcoonce/Portfolio_Website

Normes de codage Python pour la production avec détection automatique de version (3.10-3.13). À utiliser lors de l'écriture, la revue ou le refactoring de code Python pour garantir le respect des syntaxes de typage modernes, la gestion d'exceptions LBYL, les opérations pathlib, les interfaces basées sur ABC et les patterns éprouvés en production. Non spécifique à Dagster — applicable à tout projet Python.

Qu'est-ce que Portfolio_Website ?

Cette compétence définit des normes de codage Python de qualité production, destinées à écrire un code propre, maintenable et moderne compatible avec Python 3.10 à 3.13. Elle détecte automatiquement la version minimale de Python utilisée par le projet (via pyproject.toml, setup.py, .python-version ou par défaut 3.12) et charge le fichier de référence approprié pour cette version. Elle fournit des directives complètes couvrant le typage moderne, la gestion d'exceptions LBYL (Look Before You Leap), les opérations avec pathlib, les interfaces basées sur ABC/Protocol, les patterns CLI (Click, argparse), la gestion des sous-processus, la conception d'API et des listes de vérification pour la revue finale. Conçue pour les agents comme Claude Code, Cursor ou Codex, elle s'active automatiquement sur des demandes comme « rends ce code pythonique », « type hints », « LBYL vs EAFP », ou « revue de code ». Les fichiers de référence sont chargés à la demande selon les motifs détectés dans la tâche (par exemple : mention de « click » charge cli-patterns.md), et une table d'aide indique clairement quand utiliser cette compétence par rapport à d'autres (notamment /dagster-expert).

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Compétence : Normes de codage Python dignes

Normes de codage Python de qualité production pour écrire un code Python propre, maintenable et moderne (versions 3.10-3.13).

Quand utiliser cette compétence

Auto-invocation lorsque les utilisateurs demandent :

  • « rends ce code pythonique » / « est-ce que c'est du bon Python »
  • « indications de type » / « annotations de type » / « typage »
  • « LBYL vs EAFP » / « gestion d'exceptions »
  • « pathlib vs os.path » / « opérations sur les chemins »
  • « patterns CLI » / « utilisation de click »
  • « revue de code » / « améliore ce code »
  • Toute question sur la qualité ou les normes du code Python

Remarque : Cette compétence concerne les normes Python générales, pas spécifiques à Dagster. Utilisez /dagster-expert pour les patterns Dagster.

Quand utiliser cette compétence vs. d'autres

Besoin utilisateurUtiliser cette compétenceCompétence alternative
« rends ce code pythonique »✅ Oui - normes Python
« est-ce que c'est du bon Python »✅ Oui - qualité de code
« indications de type »✅ Oui - conseils de typage
« LBYL vs EAFP »✅ Oui - patterns d'exception
« pathlib vs os.path »✅ Oui - gestion des chemins
« patterns spécifiques à Dagster »❌ Non/dagster-expert
« analyse d'arguments CLI »✅ Oui - patterns CLI

Connaissances de base (TOUJOURS chargées)

dignified-python-core.md

Détection de version

Identifier la version minimale de Python du projet en vérifiant (dans l'ordre) :

  1. pyproject.toml - Chercher le champ requires-python (ex. requires-python = ">=3.12")
  2. setup.py ou setup.cfg - Chercher python_requires
  3. Fichier .python-version - Contient la version comme 3.12 ou 3.12.0
  4. Par défaut, Python 3.12 si aucun spécificateur de version n'est trouvé

Une fois identifiée, charger le fichier spécifique à la version :

  • Python 3.10 : Charger versions/python-3.10.md
  • Python 3.11 : Charger versions/python-3.11.md
  • Python 3.12 : Charger versions/python-3.12.md
  • Python 3.13 : Charger versions/python-3.13.md

Chargement conditionnel (charger selon les motifs de la tâche)

Les fichiers de base ci-dessus couvrent 80 %+ des patterns de code Python. Chargez ces fichiers supplémentaires uniquement lorsque vous détectez des motifs spécifiques :

Exemples de détection de motifs :

  • Si la tâche mentionne « click » ou « CLI » -> Charger cli-patterns.md
  • Si la tâche mentionne « subprocess » -> Charger subprocess.md

Structure de la documentation de référence

Les documents de référence sont organisés dans des fichiers de premier niveau et des sous-répertoires :

Références principales (à côté de SKILL.md)

  • dignified-python-core.md - Normes essentielles (toujours chargées)
  • cli-patterns.md - Patterns d'interface en ligne de commande (click, argparse)
  • subprocess.md - Opérations de sous-processus

Références spécifiques à une version (versions/)

  • versions/python-3.10.md - Fonctionnalités disponibles dans Python 3.10+
  • versions/python-3.11.md - Fonctionnalités disponibles dans Python 3.11+
  • versions/python-3.12.md - Fonctionnalités disponibles dans Python 3.12+
  • versions/python-3.13.md - Fonctionnalités disponibles dans Python 3.13+

Sujets avancés (references/advanced/)

  • exception-handling.md - Patterns LBYL, limites d'erreur
  • interfaces.md - Patterns ABC et Protocol
  • typing-advanced.md - Patterns de typage avancés
  • api-design.md - Principes de conception d'API

Quand lire chaque document de référence

references/advanced/exception-handling.md

Lire quand :

  • Écrire des blocs try/except
  • Encapsuler des API tierces susceptibles de lever des exceptions
  • Voir ou écrire from e ou from None
  • Ne pas savoir si une alternative LBYL existe

references/advanced/interfaces.md

Lire quand :

  • Créer des classes ABC ou Protocol
  • Écrire des décorateurs @abstractmethod
  • Concevoir des interfaces de couche de passerelle
  • Choisir entre ABC et Protocol

references/advanced/typing-advanced.md

Lire quand :

  • Utiliser typing.cast()
  • Créer des alias de type Literal
  • Rétrécir les types dans les blocs conditionnels

references/module-design.md

Lire quand :

  • Créer de nouveaux modules Python
  • Ajouter du code au niveau du module (au-delà de constantes simples)
  • Utiliser le décorateur @cache au niveau du module
  • Voir Path() ou des calculs au niveau du module
  • Envisager des importations inline

references/api-design.md

Lire quand :

  • Ajouter des valeurs de paramètres par défaut aux fonctions
  • Définir des fonctions avec 5 paramètres ou plus
  • Utiliser ThreadPoolExecutor.submit()
  • Réviser les signatures de fonctions

references/checklists.md

Lire quand :

  • Faire une revue finale avant de valider du code Python
  • Ne pas savoir si vous avez suivi toutes les règles
  • Avoir besoin d'une consultation rapide des exigences

Comment utiliser cette compétence

  1. Connaissances de base chargées automatiquement (LBYL, pathlib, importations de base, anti-patrons)
  2. Détection de version effectuée une fois - identifier la version minimale de Python et charger le fichier de version approprié
  3. Documents de référence chargés à la demande selon les déclencheurs ci-dessus
  4. Patterns supplémentaires peuvent nécessiter un chargement supplémentaire (patterns CLI, sous-processus)
  5. Chaque fichier est autonome avec des conseils complets pour son domaine

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.

Skills associés