CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

69

Quality

84%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Discovery

92%

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

This is a strong description that clearly articulates specific capabilities and provides explicit trigger guidance for when to use the skill. It covers a wide range of natural keywords that developers would use. The main weakness is its broad scope, which could cause overlap with other Python-related skills in a large skill library.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: generates type-annotated code, configures mypy in strict mode, writes pytest test suites with fixtures and mocking, validates code with black and ruff, and covers dataclasses, dependency injection, logging configuration, and structured error handling.

3 / 3

Completeness

Clearly answers both 'what' (generates type-annotated Python 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' and 'Invoke for type hints, async/await patterns...'). Explicit trigger guidance is present.

3 / 3

Trigger Term Quality

Includes many natural keywords users would say: 'Python 3.11+', 'type hints', 'async/await', 'dataclasses', 'pytest', 'mypy', 'black', 'ruff', 'dependency injection', 'logging', 'error handling', 'type safety'. These cover a broad range of terms a developer would naturally use.

3 / 3

Distinctiveness Conflict Risk

While it specifies Python 3.11+ with type safety and async focus, the scope is quite broad—covering testing, linting, logging, error handling, and dependency injection. This could overlap with a general Python coding skill, a testing skill, or a linting/formatting skill. The niche is not as tightly defined as it could be.

2 / 3

Total

11

/

12

Passed

Implementation

77%

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

This is a solid, well-structured skill with excellent actionability through complete, executable code examples and a clear workflow with validation feedback loops. Its main weaknesses are moderate verbosity—some constraints and the knowledge reference list state things Claude already knows—and the referenced bundle files don't actually exist, undermining the progressive disclosure structure. Trimming obvious best practices and ensuring bundle files are provided would elevate this skill significantly.

Suggestions

Remove or significantly trim the MUST NOT DO items that reflect basic Python knowledge Claude already has (e.g., mutable default arguments, bare except clauses) to improve conciseness.

Remove the 'Knowledge Reference' flat list at the bottom—Claude already knows these libraries and modules, and the reference table above already covers when to load detailed guidance.

Provide the referenced bundle files (references/type-system.md, references/async-patterns.md, etc.) or remove the reference table if they don't exist, as broken references reduce the skill's utility.

DimensionReasoningScore

Conciseness

The skill is reasonably efficient but includes some unnecessary content. The 'Knowledge Reference' section at the bottom is a flat list of things Claude already knows. The MUST DO/MUST NOT DO lists contain some items that are basic Python best practices Claude would already follow (e.g., 'don't use mutable default arguments', 'don't use bare except clauses'). The code examples are useful but collectively make the file quite long.

2 / 3

Actionability

The skill provides fully executable, copy-paste-ready code examples covering type-annotated functions, dataclasses with validation, async patterns, pytest fixtures with parametrize, and mypy configuration. Each example is complete and runnable, with specific commands for validation tools.

3 / 3

Workflow Clarity

The Core Workflow section provides a clear 5-step sequence with explicit validation checkpoints in step 5. It includes feedback loops: if mypy fails, fix and re-run; if tests fail, debug and iterate; if ruff/black reports issues, apply auto-fixes and re-validate. The mypy section also explicitly states errors must be resolved before implementation is considered complete.

3 / 3

Progressive Disclosure

The reference table pointing to topic-specific files (type-system.md, async-patterns.md, etc.) with 'Load When' guidance is well-structured. However, no bundle files are provided, so these references point to non-existent files. Additionally, the main SKILL.md contains substantial inline content (multiple code examples, detailed constraints) that could be offloaded to reference files, making the overview heavier than ideal.

2 / 3

Total

10

/

12

Passed

Validation

100%

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

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
jeffallan/claude-skills
Reviewed

Table of Contents

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.