python-pro

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.

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Failed to scan

The risk profile of this skill

Quality

Content

87%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

Well-structured, actionable skill body with executable examples, an explicit validation-feedback workflow, and clean one-level-deep progressive disclosure to real reference files. Minor conciseness gains are available by trimming widely-known conventions in the constraints and knowledge list.

Dimension	Reasoning	Score
Conciseness	Mostly efficient — workflow, constraints, and code examples are tight and assume competence — but the Knowledge Reference list and some MUST DO/MUST NOT DO bullets restate widely-known Python conventions (PEP 8, 'dataclasses over manual __init__') that could be trimmed.	4 / 5
Actionability	Provides fully executable, copy-paste-ready code examples (typed function with error handling, dataclass with validation, async fetch_all, pytest fixture/parametrize, pyproject.toml mypy config) plus specific commands (mypy --strict, black, ruff) covering the common cases.	5 / 5
Workflow Clarity	The Core Workflow is a clear 5-step sequence with an explicit Validate step and feedback loops ('If mypy fails: fix type errors... and re-run', 'If tests fail: ...iterate until green', 'apply auto-fixes, then re-validate'), satisfying the validation-checkpoint requirement for batch/validation-sensitive operations.	5 / 5
Progressive Disclosure	A clear overview SKILL.md with a well-signaled reference table mapping each topic to a real one-level-deep file in references/ (type-system, async-patterns, standard-library, testing, packaging), each with a 'Load When' column for easy navigation; all referenced files exist.	5 / 5
	Total	19 / 20 Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, specific description that clearly states what the skill does and when to invoke it, with concrete trigger terms and a distinct niche. It is concise yet comprehensive without vague fluff or over-claims.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — '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' — with comprehensive coverage of the skill's capabilities.	5 / 5
Completeness	Explicitly answers both 'what' (generates type-annotated code, configures mypy, writes pytest suites, validates with black/ruff) and 'when' ('Use when building Python 3.11+ applications requiring type safety, async programming, or robust error handling', plus the 'Invoke for...' clause with concrete trigger phrases).	5 / 5
Trigger Term Quality	Includes comprehensive natural terms users would say — 'type hints, async/await patterns, dataclasses, dependency injection, logging configuration, and structured error handling' — with strong synonym coverage across the skill's domains.	5 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (Python 3.11+ type-safe, async-first specialist) with distinct triggers (mypy strict, pytest, black/ruff, dataclasses) and minimal overlap risk with general skills; metadata also scopes it via related-skills to fastapi-expert and devops-engineer.	5 / 5
	Total	20 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: jeffallan/claude-skills
Path: skills/python-pro/SKILL.md
Commit: 882ef55

Reviewed: 5 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.