Back to catalog
Human reviewedDevelopment

Skill dossier

python-pro

Source declaration

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/await patterns, dataclasses, dependency injection, logging configuration, and structured error handling.

The author's original description, preserved in English. It describes intent, not verified performance.

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/await patterns, dataclasses, dependency injection, logging configuration, and structured error handling.

developmentreferences

Research summary

Human reviewed

Skill Atlas editorial review · editorial-preview-1.0.0

A Python 3.11+ specialist that writes type-annotated code, pytest suites and validates with mypy strict, black and ruff.

Review scope

Deterministic static analysis of collected SKILL.md and supporting text/code. Machine-assisted candidates and findings await human editorial review; no dynamic behavior or effect is assessed.

Observable capabilities

  • Reviews codebase structure, dependencies, type coverage and tests before changing code.
  • Designs interfaces with protocols, dataclasses and type aliases.
  • Writes a pytest suite with fixtures, mocking and a stated coverage target above 90%.
  • Runs mypy --strict, black and ruff and fixes reported issues before finishing.

Limitations & scope

  • Scoped to Python 3.11+; older runtimes are not addressed.
  • The >90% coverage and mypy-strict requirements may be heavy for small scripts.
  • This review did not run the tools or the example code.

Relevant for

  • Python developers wanting strict typing
  • Teams adopting async I/O patterns
  • Maintainers adding pytest coverage

What ships with the skill

The file inventory comes from the collected source at the recorded commit. Paths and sizes are structural observations, not a measure of quality.

files
6
Markdown files
6
scripts
0
references
5
Size
49.7 KB
Structural complexity
Low

File inventory

PathTypeBytes
skills/python-pro/references/async-patterns.mdReference9.1 KB
skills/python-pro/references/packaging.mdReference9.4 KB
skills/python-pro/references/standard-library.mdReference8.9 KB
skills/python-pro/references/testing.mdReference9.7 KB
skills/python-pro/references/type-system.mdReference6.5 KB
skills/python-pro/SKILL.mdInstruction6.1 KB

SKILL.md frontmatter

{
  "name": "python-pro",
  "description": "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/await patterns, dataclasses, dependency injection, logging configuration, and structured error handling.",
  "license": "MIT",
  "metadata": {
    "author": "https://github.com/Jeffallan",
    "company": "https://synergetic.solutions",
    "version": "1.1.0",
    "domain": "language",
    "triggers": "Python development, type hints, async Python, pytest, mypy, dataclasses, Python best practices, Pythonic code",
    "role": "specialist",
    "scope": "implementation",
    "output-format": "code",
    "related-skills": "fastapi-expert, devops-engineer"
  }
}

A reading of the operating sequence

This workflow reconstructs the apparent sequence from source material. Unless controlled evaluation is explicitly recorded, it is provisional—not an observed trace.

  1. 01
    Input

    Analyze codebase

    Review structure, dependencies, type coverage and the existing test suite.

  2. 02
    Action

    Implement with full typing

    Write Pythonic code with full type hints and error handling after designing interfaces.

  3. 03
    Decision

    Resolve validation failures

    If mypy fails, fix the type errors and re-run before proceeding.

  4. 04
    Output

    Deliver module and tests

    Provide the module, a pytest file, mypy --strict confirmation and a short explanation.

Potential risk surfaces

Static findings identify points to inspect before installation. They do not establish that a skill is safe, malicious, or effective.

Items warrant review

207 deterministic lexical finding(s) require review across the collected text. Findings can occur in documentation and do not prove execution or exploitability; binary-only files were not scanned.

Network accessObserved
File writesObserved
Credential useNot observed
Note

File modification is described or implemented

188 occurrences

This line contains a possible file-write or redirection operation. Check destination paths and overwrite behavior; the static review did not write any file. This rule matched 188 location(s) in the collected text; 3 representative location(s) are cited. Matching text may be documentation, and the analyzer did not execute it.

Medium

Network access is mentioned

19 occurrences

A URL or network client appears in this source line. Review destinations, data sent, and trust boundaries; static text cannot establish actual network activity. This rule matched 19 location(s) in the collected text; 3 representative location(s) are cited. Matching text may be documentation, and the analyzer did not execute it.

Editorial security note

Review any shell commands it runs for linting and dependency installation, and confirm it does not hardcode configuration or secrets.

Where context can be spent

Discovery, activation, and resource layers have different meanings. Exact values appear only when the official token-counting method was run with a named model.

Exact token counts unavailable

All token values, including per-file inventory, are null until the pipeline performs an official exact count with an explicit model.

No token measurement was recorded with the required official method. This dossier does not substitute character counts, file sizes, or estimates.

Controlled evaluation

No controlled evaluation

This skill has only the evidence identified above. No task success, token efficiency, latency, or quality advantage is claimed.

Not tested

Use with the source in view

Install command
git clone https://github.com/Jeffallan/claude-skills.git cd claude-skills # Copy this skill directory into one of: # ~/.claude/skills/python-pro # .claude/skills/python-pro
  1. Open the pinned source at https://github.com/Jeffallan/claude-skills/blob/67c1961b180dc92cf08983344627109e983e8f51/skills/python-pro/SKILL.md.
  2. Review the license, prerequisites and all bundled resources.
  3. Install the skill into a personal or project-level Claude Code skills directory.
  4. Restart or refresh Claude Code so the skill can be discovered.
Verify installation

Check that SKILL.md for python-pro is discoverable at the destination, then ask Claude Code to use it on a small test task.

Prerequisites

  • Scoped to Python 3.11+; older runtimes are not addressed.
  • The >90% coverage and mypy-strict requirements may be heavy for small scripts.
  • This review did not run the tools or the example code.

Example prompts

Representative task

Use the python-pro skill to add full type hints to src/ingest/client.py, convert its fetch loop to asyncio with httpx, and add pytest tests with fixtures. Run mypy --strict and report the result.

Inspect before use

Read the python-pro skill files at https://github.com/Jeffallan/claude-skills/blob/67c1961b180dc92cf08983344627109e983e8f51/skills/python-pro/SKILL.md. Explain its workflow, required tools, permissions and the main risks before I decide whether to install it.

A decision, with its limits attached

Strengths

  • Concrete validation loop with mypy, black and ruff.
  • Explicit MUST/MUST NOT lists such as no bare except or mutable defaults.

Considerations

  • Prescribes Poetry and specific style choices that may clash with your project.
  • Strict rules can slow quick prototypes.
Research conclusion

A solid default for typed, tested modern Python when your project accepts its tooling choices.

Traceable by construction

The dossier is a time-bound reading of a public artifact, not an endorsement. Use the source link to inspect the exact upstream material.

Jeffallanclaude-skillsskills/python-pro
Source type
Community
Commit
67c1961b180dc92cf08983344627109e983e8f51
Collected
20 Nov 2026
Last checked
20 Nov 2026
Upstream license
MIT
Repository stars
12,464
Content basis

Deterministic lexical parsing, YAML frontmatter validation, file inventory, source-described workflow extraction, and heuristic provisional classification of the supplied files only. Generated by machine; no LLM, execution, dynamic testing, or human editorial approval.