Communitygithub.com

cdcoonce/Portfolio_Website

Estándares de codificación Python de producción con detección automática de versión (3.10-3.13). Úselo al escribir, revisar o refactorizar Python para garantizar el cumplimiento de sintaxis de tipos moderna, manejo de excepciones LBYL, operaciones con pathlib, interfaces basadas en ABC y patrones probados en producción. No es específico de Dagster: se aplica a cualquier proyecto Python.

¿Qué es Portfolio_Website?

Esta habilidad proporciona un conjunto completo de estándares de codificación Python de producción, diseñados para escribir código limpio, mantenible y moderno compatible con las versiones 3.10 a 3.13. Se activa automáticamente cuando los usuarios hacen preguntas sobre cómo hacer que el código sea más pitónico, revisiones de código, sugerencias de tipo, manejo de excepciones LBYL frente a EAFP, operaciones con pathlib o patrones de CLI. La habilidad detecta automáticamente la versión mínima de Python del proyecto examinando archivos como `pyproject.toml`, `setup.py`, `setup.cfg` o `.python-version`, y luego carga archivos de referencia específicos de la versión para garantizar que se utilicen las características adecuadas. Además de los conocimientos básicos siempre cargados, la habilidad incluye documentos de referencia bajo demanda para temas avanzados como manejo de excepciones, interfaces (ABC y Protocol), patrones de tipado avanzados, diseño de API y listas de verificación. Es importante destacar que esta habilidad es de propósito general y no está limitada a Dagster; se aplica a cualquier proyecto Python que busque altos estándares de calidad.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Habilidad de Estándares de Codificación Python Dignos

Estándares de codificación Python de calidad de producción para escribir código Python limpio, mantenible y moderno (versiones 3.10-3.13).

Cuándo Usar Esta Habilidad

Se activa automáticamente cuando los usuarios preguntan sobre:

  • "haz esto más pitónico" / "es esto buen Python"
  • "sugerencias de tipo" / "anotaciones de tipo" / "tipado"
  • "LBYL vs EAFP" / "manejo de excepciones"
  • "pathlib vs os.path" / "operaciones de rutas"
  • "patrones de CLI" / "uso de click"
  • "revisión de código" / "mejora este código"
  • Cualquier pregunta sobre calidad o estándares de código Python

Nota: Esta habilidad son estándares generales de Python, no específicos de Dagster. Use /dagster-expert para patrones de Dagster.

Cuándo Usar Esta Habilidad vs. Otras

Necesidad del UsuarioUsar Esta HabilidadHabilidad Alternativa
"haz esto más pitónico"✅ Sí - estándares Python
"es esto buen Python"✅ Sí - calidad de código
"sugerencias de tipo"✅ Sí - guía de tipado
"LBYL vs EAFP"✅ Sí - patrones de excepción
"pathlib vs os.path"✅ Sí - manejo de rutas
"patrones específicos de Dagster"❌ No/dagster-expert
"análisis de argumentos CLI"✅ Sí - patrones de CLI

Conocimiento Central (SIEMPRE Cargado)

dignified-python-core.md

Detección de Versión

Identifique la versión mínima de Python del proyecto verificando (en orden):

  1. pyproject.toml - Busque el campo requires-python (ej., requires-python = ">=3.12")
  2. setup.py o setup.cfg - Busque python_requires
  3. Archivo .python-version - Contiene la versión como 3.12 o 3.12.0
  4. Por defecto a Python 3.12 si no se encuentra un especificador de versión

Una vez identificada, cargue el archivo específico de la versión adecuado:

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

Carga Condicional (Cargar Según Patrones de Tarea)

Los archivos centrales anteriores cubren más del 80% de los patrones de código Python. Solo cargue estos archivos adicionales cuando detecte patrones específicos:

Ejemplos de detección de patrones:

  • Si la tarea menciona "click" o "CLI" -> Cargar cli-patterns.md
  • Si la tarea menciona "subprocess" -> Cargar subprocess.md

Estructura de la Documentación de Referencia

Los documentos de referencia están organizados en archivos de nivel superior y subdirectorios:

Referencias Centrales (junto a SKILL.md)

  • dignified-python-core.md - Estándares esenciales (siempre cargados)
  • cli-patterns.md - Patrones de interfaz de línea de comandos (click, argparse)
  • subprocess.md - Operaciones de subprocesos

Referencias Específicas de Versión (versions/)

  • versions/python-3.10.md - Características disponibles en Python 3.10+
  • versions/python-3.11.md - Características disponibles en Python 3.11+
  • versions/python-3.12.md - Características disponibles en Python 3.12+
  • versions/python-3.13.md - Características disponibles en Python 3.13+

Temas Avanzados (references/advanced/)

  • exception-handling.md - Patrones LBYL, límites de error
  • interfaces.md - Patrones ABC y Protocol
  • typing-advanced.md - Patrones de tipado avanzados
  • api-design.md - Principios de diseño de API

Cuándo Leer Cada Documento de Referencia

references/advanced/exception-handling.md

Leer cuando:

  • Escribiendo bloques try/except
  • Envolviendo APIs de terceros que puedan lanzar excepciones
  • Viendo o escribiendo from e o from None
  • No está seguro si existe una alternativa LBYL

references/advanced/interfaces.md

Leer cuando:

  • Creando clases ABC o Protocol
  • Escribiendo decoradores @abstractmethod
  • Diseñando interfaces de capa de puerta de enlace
  • Eligiendo entre ABC y Protocol

references/advanced/typing-advanced.md

Leer cuando:

  • Usando typing.cast()
  • Creando alias de tipo Literal
  • Estrechando tipos en bloques condicionales

references/module-design.md

Leer cuando:

  • Creando nuevos módulos Python
  • Agregando código a nivel de módulo (más allá de constantes simples)
  • Usando el decorador @cache a nivel de módulo
  • Viendo Path() o cómputo a nivel de módulo
  • Considerando importaciones en línea

references/api-design.md

Leer cuando:

  • Agregando valores de parámetros por defecto a funciones
  • Definiendo funciones con 5 o más parámetros
  • Usando ThreadPoolExecutor.submit()
  • Revisando firmas de funciones

references/checklists.md

Leer cuando:

  • Revisión final antes de confirmar código Python
  • No está seguro si ha seguido todas las reglas
  • Necesita una consulta rápida de requisitos

Cómo Usar Esta Habilidad

  1. El conocimiento central se carga automáticamente (LBYL, pathlib, importaciones básicas, antipatrones)
  2. La detección de versión ocurre una vez: identifique la versión mínima de Python y cargue el archivo de versión adecuado
  3. Los documentos de referencia se cargan bajo demanda según los disparadores anteriores
  4. Patrones adicionales pueden requerir carga extra (patrones de CLI, subprocesos)
  5. Cada archivo es autocontenido con guía completa para su dominio

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 relacionados