CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

73

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%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.

A well-engineered skill body: executable examples, explicit validation feedback loops, and clean progressive disclosure through a load-condition reference table. Only minor token waste in the Knowledge Reference section and footer keeps it from full marks on conciseness.

DimensionReasoningScore

Conciseness

The body is efficient: terse constraint lists, lean code examples, no explanation of concepts Claude already knows. Not a 5 because the "Knowledge Reference" section is a redundant keyword list already covered by the description and When-to-Use section, and the maintainer/doc-link footer is non-functional padding.

4 / 5

Actionability

All examples are complete and executable: a type-annotated config parser with docstring and raises, a validated dataclass, an async httpx fetcher, parametrized pytest fixtures, and a copy-paste mypy strict pyproject.toml with expected output ("Success: no issues found"). The MUST DO / MUST NOT DO lists give concrete rules rather than vague direction.

5 / 5

Workflow Clarity

The 5-step Core Workflow has an explicit validation step ("Run mypy --strict, black, ruff") with per-tool failure feedback loops: "If mypy fails: fix type errors reported and re-run before proceeding" and "iterate until green". Clear sequence, explicit checkpoints, and error-recovery loops match the top anchor.

5 / 5

Progressive Disclosure

A reference table maps each topic to an existing one-level-deep file (all five listed reference files are present with substantial content) with a "Load When" column signaling when to load each. The SKILL.md stays an overview with inline examples appropriately kept short, making navigation easy.

5 / 5

Total

19

/

20

Passed

Description

88%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 description with explicit what and when clauses, multiple concrete actions, and natural trigger terms. The only weaknesses are a few missing common phrasings/synonyms and minor overlap risk with adjacent Python-framework skills.

Suggestions

Add one or two natural user phrasings such as "Pythonic code" or "type checking" to broaden trigger coverage.

Narrow the scope slightly (e.g. mention it defers to fastapi-expert for framework-specific work) to reduce overlap with related skills.

DimensionReasoningScore

Specificity

Lists four concrete actions spanning the workflow — "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" — which comprehensively covers the skill's capabilities. Not a 4 because there are no meaningful gaps: generation, configuration, testing, and validation are all explicitly named.

5 / 5

Completeness

Explicitly answers both questions: the what ("Generates type-annotated Python code, configures mypy...") and the when ("Use when building Python 3.11+ applications requiring type safety..." plus "Invoke for type hints, async/await patterns..."). Both what and when are present with concrete trigger phrases, matching the anchor exactly.

5 / 5

Trigger Term Quality

Good natural coverage: "type hints", "async/await patterns", "dataclasses", "pytest", "mypy", "logging configuration", "structured error handling" are phrases users would naturally say. Not a 5 because common variations like "Pythonic code", "type checking", "Python testing", or "code review" phrasings are absent.

4 / 5

Distinctiveness Conflict Risk

The Python 3.11+ / type-safety / async niche is clear and mostly distinct. Minor overlap risk with closely related skills remains: the broad Python scope could compete with the declared related-skills (e.g. fastapi-expert) or a data-science Python skill, so it is not a 5.

4 / 5

Total

18

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

Jeffallan/claude-skills

Path

skills/python-pro/SKILL.md

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.