[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M753VNAWHH2FNPTA7MFFSTPW":3,"skill-same:01M753VNAWHH2FNPTA7MFFSTPW":77},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":33,"commitSha":34,"skillDirectory":35,"forksCount":14,"repositoryHtmlUrl":36,"repositoryHomepageUrl":6,"ownerHtmlUrl":37,"ownerBlogUrl":38,"ownerDescription":39,"updatedAt":40,"install":41,"resources":54},"01M753VNAWHH2FNPTA7MFFSTPW","python-pro",null,"Use when building Python 3.11+ applications requiring type safety, async programming, or robust error handling. Generates type-annotated Python code, configures mypy in strict mode, writes pytest test suites with fixtures and mocking, and validates code with black and ruff. Invoke for type hints, async\u002Fawait patterns, dataclasses, dependency injection, logging configuration, and structured error handling.","haryelramalho\u002Fskills","haryelramalho","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F38708454?v=4","01M753ESC6XNS6GXGV5X9YMKGA","Haryel Ramalho","01M753ESCSPRNDTEJRVRYY1VJ0",0,"MIT","https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcurated\u002Fpython-pro\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: python-pro\ndescription: Use when building Python 3.11+ applications requiring type safety, async programming, or robust error handling. Generates type-annotated Python code, configures mypy in strict mode, writes pytest test suites with fixtures and mocking, and validates code with black and ruff. Invoke for type hints, async\u002Fawait patterns, dataclasses, dependency injection, logging configuration, and structured error handling.\nlicense: MIT\nmetadata:\n  author: https:\u002F\u002Fgithub.com\u002FJeffallan\n  version: \"1.1.0\"\n  domain: language\n  triggers: Python development, type hints, async Python, pytest, mypy, dataclasses, Python best practices, Pythonic code\n  role: specialist\n  scope: implementation\n  output-format: code\n  related-skills: fastapi-expert, devops-engineer\n---\n\n# Python Pro\n\nModern Python 3.11+ specialist focused on type-safe, async-first, production-ready code.\n\n## When to Use This Skill\n\n- Writing type-safe Python with complete type coverage\n- Implementing async\u002Fawait patterns for I\u002FO operations\n- Setting up pytest test suites with fixtures and mocking\n- Creating Pythonic code with comprehensions, generators, context managers\n- Building packages with Poetry and proper project structure\n- Performance optimization and profiling\n\n## Core Workflow\n\n1. **Analyze codebase** — Review structure, dependencies, type coverage, test suite\n2. **Design interfaces** — Define protocols, dataclasses, type aliases\n3. **Implement** — Write Pythonic code with full type hints and error handling\n4. **Test** — Create comprehensive pytest suite with >90% coverage\n5. **Validate** — Run `mypy --strict`, `black`, `ruff`\n   - If mypy fails: fix type errors reported and re-run before proceeding\n   - If tests fail: debug assertions, update fixtures, and iterate until green\n   - If ruff\u002Fblack reports issues: apply auto-fixes, then re-validate\n\n## Reference Guide\n\nLoad detailed guidance based on context:\n\n| Topic | Reference | Load When |\n|-------|-----------|-----------|\n| Type System | `references\u002Ftype-system.md` | Type hints, mypy, generics, Protocol |\n| Async Patterns | `references\u002Fasync-patterns.md` | async\u002Fawait, asyncio, task groups |\n| Standard Library | `references\u002Fstandard-library.md` | pathlib, dataclasses, functools, itertools |\n| Testing | `references\u002Ftesting.md` | pytest, fixtures, mocking, parametrize |\n| Packaging | `references\u002Fpackaging.md` | poetry, pip, pyproject.toml, distribution |\n\n## Constraints\n\n### MUST DO\n- Type hints for all function signatures and class attributes\n- PEP 8 compliance with black formatting\n- Comprehensive docstrings (Google style)\n- Test coverage exceeding 90% with pytest\n- Use `X | None` instead of `Optional[X]` (Python 3.10+)\n- Async\u002Fawait for I\u002FO-bound operations\n- Dataclasses over manual __init__ methods\n- Context managers for resource handling\n\n### MUST NOT DO\n- Skip type annotations on public APIs\n- Use mutable default arguments\n- Mix sync and async code improperly\n- Ignore mypy errors in strict mode\n- Use bare except clauses\n- Hardcode secrets or configuration\n- Use deprecated stdlib modules (use pathlib not os.path)\n\n## Code Examples\n\n### Type-annotated function with error handling\n```python\nfrom pathlib import Path\n\ndef read_config(path: Path) -> dict[str, str]:\n    \"\"\"Read configuration from a file.\n\n    Args:\n        path: Path to the configuration file.\n\n    Returns:\n        Parsed key-value configuration entries.\n\n    Raises:\n        FileNotFoundError: If the config file does not exist.\n        ValueError: If a line cannot be parsed.\n    \"\"\"\n    config: dict[str, str] = {}\n    with path.open() as f:\n        for line in f:\n            key, _, value = line.partition(\"=\")\n            if not key.strip():\n                raise ValueError(f\"Invalid config line: {line!r}\")\n            config[key.strip()] = value.strip()\n    return config\n```\n\n### Dataclass with validation\n```python\nfrom dataclasses import dataclass, field\n\n@dataclass\nclass AppConfig:\n    host: str\n    port: int\n    debug: bool = False\n    allowed_origins: list[str] = field(default_factory=list)\n\n    def __post_init__(self) -> None:\n        if not (1 \u003C= self.port \u003C= 65535):\n            raise ValueError(f\"Invalid port: {self.port}\")\n```\n\n### Async pattern\n```python\nimport asyncio\nimport httpx\n\nasync def fetch_all(urls: list[str]) -> list[bytes]:\n    \"\"\"Fetch multiple URLs concurrently.\"\"\"\n    async with httpx.AsyncClient() as client:\n        tasks = [client.get(url) for url in urls]\n        responses = await asyncio.gather(*tasks)\n        return [r.content for r in responses]\n```\n\n### pytest fixture and parametrize\n```python\nimport pytest\nfrom pathlib import Path\n\n@pytest.fixture\ndef config_file(tmp_path: Path) -> Path:\n    cfg = tmp_path \u002F \"config.txt\"\n    cfg.write_text(\"host=localhost\\nport=8080\\n\")\n    return cfg\n\n@pytest.mark.parametrize(\"port,valid\", [(8080, True), (0, False), (99999, False)])\ndef test_app_config_port_validation(port: int, valid: bool) -> None:\n    if valid:\n        AppConfig(host=\"localhost\", port=port)\n    else:\n        with pytest.raises(ValueError):\n            AppConfig(host=\"localhost\", port=port)\n```\n\n### mypy strict configuration (pyproject.toml)\n```toml\n[tool.mypy]\npython_version = \"3.11\"\nstrict = true\nwarn_return_any = true\nwarn_unused_configs = true\ndisallow_untyped_defs = true\n```\n\nClean `mypy --strict` output looks like:\n```\nSuccess: no issues found in 12 source files\n```\nAny reported error (e.g., `error: Function is missing a return type annotation`) must be resolved before the implementation is considered complete.\n\n## Output Templates\n\nWhen implementing Python features, provide:\n1. Module file with complete type hints\n2. Test file with pytest fixtures\n3. Type checking confirmation (mypy --strict passes)\n4. Brief explanation of Pythonic patterns used\n\n## Knowledge Reference\n\nPython 3.11+, typing module, mypy, pytest, black, ruff, dataclasses, async\u002Fawait, asyncio, pathlib, functools, itertools, Poetry, Pydantic, contextlib, collections.abc, Protocol\n\n[Documentation](https:\u002F\u002Fjeffallan.github.io\u002Fclaude-skills\u002Fskills\u002Flanguage\u002Fpython-pro\u002F)\n","# Python Pro\n\nModern Python 3.11+ specialist focused on type-safe, async-first, production-ready code.\n\n## When to Use This Skill\n\n- Writing type-safe Python with complete type coverage\n- Implementing async\u002Fawait patterns for I\u002FO operations\n- Setting up pytest test suites with fixtures and mocking\n- Creating Pythonic code with comprehensions, generators, context managers\n- Building packages with Poetry and proper project structure\n- Performance optimization and profiling\n\n## Core Workflow\n\n1. **Analyze codebase** — Review structure, dependencies, type coverage, test suite\n2. **Design interfaces** — Define protocols, dataclasses, type aliases\n3. **Implement** — Write Pythonic code with full type hints and error handling\n4. **Test** — Create comprehensive pytest suite with >90% coverage\n5. **Validate** — Run `mypy --strict`, `black`, `ruff`\n   - If mypy fails: fix type errors reported and re-run before proceeding\n   - If tests fail: debug assertions, update fixtures, and iterate until green\n   - If ruff\u002Fblack reports issues: apply auto-fixes, then re-validate\n\n## Reference Guide\n\nLoad detailed guidance based on context:\n\n| Topic | Reference | Load When |\n|-------|-----------|-----------|\n| Type System | `references\u002Ftype-system.md` | Type hints, mypy, generics, Protocol |\n| Async Patterns | `references\u002Fasync-patterns.md` | async\u002Fawait, asyncio, task groups |\n| Standard Library | `references\u002Fstandard-library.md` | pathlib, dataclasses, functools, itertools |\n| Testing | `references\u002Ftesting.md` | pytest, fixtures, mocking, parametrize |\n| Packaging | `references\u002Fpackaging.md` | poetry, pip, pyproject.toml, distribution |\n\n## Constraints\n\n### MUST DO\n- Type hints for all function signatures and class attributes\n- PEP 8 compliance with black formatting\n- Comprehensive docstrings (Google style)\n- Test coverage exceeding 90% with pytest\n- Use `X | None` instead of `Optional[X]` (Python 3.10+)\n- Async\u002Fawait for I\u002FO-bound operations\n- Dataclasses over manual __init__ methods\n- Context managers for resource handling\n\n### MUST NOT DO\n- Skip type annotations on public APIs\n- Use mutable default arguments\n- Mix sync and async code improperly\n- Ignore mypy errors in strict mode\n- Use bare except clauses\n- Hardcode secrets or configuration\n- Use deprecated stdlib modules (use pathlib not os.path)\n\n## Code Examples\n\n### Type-annotated function with error handling\n```python\nfrom pathlib import Path\n\ndef read_config(path: Path) -> dict[str, str]:\n    \"\"\"Read configuration from a file.\n\n    Args:\n        path: Path to the configuration file.\n\n    Returns:\n        Parsed key-value configuration entries.\n\n    Raises:\n        FileNotFoundError: If the config file does not exist.\n        ValueError: If a line cannot be parsed.\n    \"\"\"\n    config: dict[str, str] = {}\n    with path.open() as f:\n        for line in f:\n            key, _, value = line.partition(\"=\")\n            if not key.strip():\n                raise ValueError(f\"Invalid config line: {line!r}\")\n            config[key.strip()] = value.strip()\n    return config\n```\n\n### Dataclass with validation\n```python\nfrom dataclasses import dataclass, field\n\n@dataclass\nclass AppConfig:\n    host: str\n    port: int\n    debug: bool = False\n    allowed_origins: list[str] = field(default_factory=list)\n\n    def __post_init__(self) -> None:\n        if not (1 \u003C= self.port \u003C= 65535):\n            raise ValueError(f\"Invalid port: {self.port}\")\n```\n\n### Async pattern\n```python\nimport asyncio\nimport httpx\n\nasync def fetch_all(urls: list[str]) -> list[bytes]:\n    \"\"\"Fetch multiple URLs concurrently.\"\"\"\n    async with httpx.AsyncClient() as client:\n        tasks = [client.get(url) for url in urls]\n        responses = await asyncio.gather(*tasks)\n        return [r.content for r in responses]\n```\n\n### pytest fixture and parametrize\n```python\nimport pytest\nfrom pathlib import Path\n\n@pytest.fixture\ndef config_file(tmp_path: Path) -> Path:\n    cfg = tmp_path \u002F \"config.txt\"\n    cfg.write_text(\"host=localhost\\nport=8080\\n\")\n    return cfg\n\n@pytest.mark.parametrize(\"port,valid\", [(8080, True), (0, False), (99999, False)])\ndef test_app_config_port_validation(port: int, valid: bool) -> None:\n    if valid:\n        AppConfig(host=\"localhost\", port=port)\n    else:\n        with pytest.raises(ValueError):\n            AppConfig(host=\"localhost\", port=port)\n```\n\n### mypy strict configuration (pyproject.toml)\n```toml\n[tool.mypy]\npython_version = \"3.11\"\nstrict = true\nwarn_return_any = true\nwarn_unused_configs = true\ndisallow_untyped_defs = true\n```\n\nClean `mypy --strict` output looks like:\n```\nSuccess: no issues found in 12 source files\n```\nAny reported error (e.g., `error: Function is missing a return type annotation`) must be resolved before the implementation is considered complete.\n\n## Output Templates\n\nWhen implementing Python features, provide:\n1. Module file with complete type hints\n2. Test file with pytest fixtures\n3. Type checking confirmation (mypy --strict passes)\n4. Brief explanation of Pythonic patterns used\n\n## Knowledge Reference\n\nPython 3.11+, typing module, mypy, pytest, black, ruff, dataclasses, async\u002Fawait, asyncio, pathlib, functools, itertools, Poetry, Pydantic, contextlib, collections.abc, Protocol\n\n[Documentation](https:\u002F\u002Fjeffallan.github.io\u002Fclaude-skills\u002Fskills\u002Flanguage\u002Fpython-pro\u002F)\n",{"name":5,"license":15,"metadata":24,"description":7},{"role":25,"scope":26,"author":27,"domain":28,"version":29,"triggers":30,"output-format":31,"related-skills":32},"specialist","implementation","https:\u002F\u002Fgithub.com\u002FJeffallan","language","1.1.0","Python development, type hints, async Python, pytest, mypy, dataclasses, Python best practices, Pythonic code","code","fastapi-expert, devops-engineer","main","a5b533be2d244bbf3e5606e851742f0e0ba99423","skills\u002Fcurated\u002Fpython-pro","https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills","https:\u002F\u002Fgithub.com\u002Fharyelramalho","linkedin.com\u002Fin\u002Fharyelramalho\u002F","Software Engineer @ SKORR •  Former Vice President of the Junior Computer Association - TecnoJr","2026-07-16 01:34:58",{"source":8,"skillName":5,"commands":42,"prompt":52,"zipAvailable":53},[43,46,49],{"tool":44,"command":45},"npx","npx skills add haryelramalho\u002Fskills --skill python-pro",{"tool":47,"command":48},"bunx","bunx skills add haryelramalho\u002Fskills --skill python-pro",{"tool":50,"command":51},"pnpm","pnpm dlx skills add haryelramalho\u002Fskills --skill python-pro","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcurated\u002Fpython-pro\u002FSKILL.md",true,[55,61,65,69,73],{"path":56,"resourceType":57,"resourceTypeDesc":58,"sizeBytes":59,"sourceHtmlUrl":60},"references\u002Fasync-patterns.md","REFERENCE","参考文档",9333,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcurated\u002Fpython-pro\u002Freferences\u002Fasync-patterns.md",{"path":62,"resourceType":57,"resourceTypeDesc":58,"sizeBytes":63,"sourceHtmlUrl":64},"references\u002Fpackaging.md",9652,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcurated\u002Fpython-pro\u002Freferences\u002Fpackaging.md",{"path":66,"resourceType":57,"resourceTypeDesc":58,"sizeBytes":67,"sourceHtmlUrl":68},"references\u002Fstandard-library.md",9063,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcurated\u002Fpython-pro\u002Freferences\u002Fstandard-library.md",{"path":70,"resourceType":57,"resourceTypeDesc":58,"sizeBytes":71,"sourceHtmlUrl":72},"references\u002Ftesting.md",9920,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcurated\u002Fpython-pro\u002Freferences\u002Ftesting.md",{"path":74,"resourceType":57,"resourceTypeDesc":58,"sizeBytes":75,"sourceHtmlUrl":76},"references\u002Ftype-system.md",6638,"https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcurated\u002Fpython-pro\u002Freferences\u002Ftype-system.md",[78,85,92,99,106,113],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M753YDMKSDB7320THEQ2CVW5","to-prompt-opus","Use when preparing or rewriting prompts for Claude Opus 4.8, Anthropic API agents, XML-structured prompts, long-context document work, coding agents, research synthesis, frontend\u002Fdesign tasks, or model-specific prompt optimization. Do not use for GPT\u002FOpenAI prompts or raw context packaging without Opus-specific tuning.","https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fmine\u002Fto-prompt-opus\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M753YAP95W4K2MCEAEEAV6YA","to-prompt-gpt","Use when preparing or rewriting prompts for GPT-5.5, OpenAI API agents, Responses workflows, coding agents, research synthesis, support assistants, or model-specific prompt optimization. Do not use for Claude\u002FOpus prompts or raw context packaging without GPT-specific tuning.","https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fmine\u002Fto-prompt-gpt\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":19},"01M753Y700AZ0GVJDNW9Q1Q54F","plan-refactor-qa","Plans and runs qa-report before executing Compozy refactor tasks. Use when the user provides a refactor or issue slug and wants Codex to inspect the matching .compozy\u002Ftasks directory, related PRD\u002FTechSpec\u002FADR\u002Ftask artifacts, affected code, and existing tests, then invoke $qa-report with a repository-grounded prompt. Do not use to run tests, execute qa-execution, implement code, or perform post-refactor verification.","https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fmine\u002Fplan-refactor-qa\u002FSKILL.md",[],[],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":19},"01M753XZENG0Z8S2ET75EM8CGB","multi-tool-branch-review","Orchestrates a multi-tool branch review of the current git branch against a base branch. By default it runs two independent thermo-nuclear maintainability audits, one on Codex GPT-5.5 xhigh and one on Claude Opus xhigh, then consolidates the findings into a single remediation plan via writing-plans. If the user explicitly asks for native reviews, it can add the Claude native review pass, the Codex native review pass, or both. Use when the user wants a deep cross-model review of a branch or PR before merge, or asks to review this branch with multiple tools or models. Encodes known infra failure modes and their fixes (missing Claude ACP adapter, Codex MCP auth hangs, false-positive report files, long jobs orphaned inside subagents). Do not use for reviewing a single uncommitted snippet, for non-git work, for running only one reviewer, or when the user only wants a quick lint or test run.","https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fmine\u002Fmulti-tool-branch-review\u002FSKILL.md",[],[],{"skillNo":107,"name":108,"nameZh":6,"description":109,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":110,"categories":111,"keywords":112,"publishedAt":19},"01M753XQM40XCK55BH5WPA88EW","create-pr-with-template","Create a GitHub Pull Request with gh CLI and prefer repository PR templates automatically. Use this whenever the user asks to open\u002Fcreate a PR, especially when template compliance is needed. If multiple templates exist, ask the user which template to use.","https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fmine\u002Fcreate-pr-with-template\u002FSKILL.md",[],[],{"skillNo":114,"name":115,"nameZh":6,"description":116,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":117,"categories":118,"keywords":119,"publishedAt":19},"01M753XJMBJ8VFPRCDCC1JJ9G4","ui-craft","Provides guardrails for user-facing UI work: usability heuristics, accessibility floors, design-system discipline, component states, microcopy, motion, dark mode, responsive behavior, and human-AI UX. Use when designing, generating, reviewing, or refactoring visible product surfaces such as components, pages, dashboards, forms, dialogs, loading\u002Fempty\u002Ferror states, or AI interfaces. Do not use for backend-only work, infrastructure, CLI\u002FTUI design, or pure documentation editing.","https:\u002F\u002Fgithub.com\u002Fharyelramalho\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fcurated\u002Fui-craft\u002FSKILL.md",[],[]]