CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

python-patterns

Pythonic idioms, PEP 8 standards, type hints, and best practices for building robust, efficient, and maintainable Python applications.

Quality

63%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/python-patterns/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body is well-organized and rich in executable examples, but it spends most of its tokens restating standard Python knowledge Claude already has and keeps everything in one monolithic file with no progressive disclosure. Trimming known basics and splitting deep-dive material into reference files would substantially improve it.

Suggestions

Cut sections that restate basic Python knowledge (comprehensions, "is None" comparisons, mutable defaults, bare except, join vs +=) down to a short anti-patterns list, keeping only the project-specific conventions.

Split deep-dive material (concurrency patterns, full pyproject.toml/tooling configuration, package layout) into reference files under references/ and link to them from a lean SKILL.md overview.

Add a sequenced validation loop for the review/refactoring use cases, e.g. format -> lint (ruff) -> type-check (mypy) -> test (pytest), so the tooling commands form a workflow rather than a menu.

Fix examples with undefined names (default_value, db, conn, user_data) and missing imports so snippets are truly copy-paste ready.

DimensionReasoningScore

Conciseness

The ~750-line body catalogs concepts Claude already knows (list comprehensions, generator expressions, decorators, context managers, "is None vs == None", mutable default arguments, join vs += in loops), which the guidelines explicitly penalize. It scores above 1 only because the format is dense good/bad code pairs rather than padded prose, and a few sections (pyproject.toml tooling config, project layout) add genuine curation value.

2 / 5

Actionability

The body is dominated by concrete, mostly executable code and specific commands (black, isort, ruff, mypy, pytest, bandit, pip-audit) plus a complete pyproject.toml. It falls short of 5 due to minor gaps: several snippets reference undefined names (default_value in the EAFP example, db, conn, user_data, Config) and omit imports (Callable, Iterator, Iterable, json, time in places).

4 / 5

Workflow Clarity

This is a reference catalog with no multi-step sequence and no validation checkpoints; the tooling commands are listed as a menu rather than a verify loop, and the "When to Activate" section gives contexts but no process. It is not a 2 because the content is coherent and clearly organized by topic, but no explicit checkpoints exist to justify 4.

3 / 5

Progressive Disclosure

There are no bundle files and no references to any external files; all ~750 lines are inline even though content like the concurrency patterns and full tooling configuration clearly belong in separate reference files. Good hierarchical headers and a quick-reference table keep it above the "minimal structure" anchor, but nothing is split out or navigable via links.

3 / 5

Total

12

/

20

Passed

Description

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

The description identifies a clear Python style/idioms niche with recognizable trigger terms, but it completely lacks activation guidance and pads its capabilities with generic quality buzzwords. Adding an explicit "Use when..." clause would fix its largest weakness.

Suggestions

Add an explicit trigger clause, e.g. "Use when writing, reviewing, or refactoring Python code, or when the user mentions PEP 8, type hints, or Pythonic style."

Replace "best practices for building robust, efficient, and maintainable Python applications" with concrete capabilities drawn from the body (e.g. error-handling patterns, concurrency patterns, tooling configuration).

Include a few natural synonym phrases users actually say, such as "Python code style" or "clean Python code", to broaden trigger coverage.

DimensionReasoningScore

Specificity

The description names concrete topics ("Pythonic idioms, PEP 8 standards, type hints") but follows them with vague buzzword padding ("best practices for building robust, efficient, and maintainable Python applications") and uses no action verbs, so it sits between the 1-2-concrete-actions anchor and the several-specific-actions anchor.

3 / 5

Completeness

The "what" is clear (idioms, PEP 8, type hints, best practices), but there is no "Use when..." clause or equivalent trigger guidance anywhere, which the guidelines cap at 3. It is not a 4 because the "when" is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

"PEP 8", "type hints", "Pythonic", and "best practices" are phrases users naturally say when they need this skill, giving good keyword coverage. It falls short of a 5 because common variations like "code style", "linting", "Python style guide", or "refactoring" are missing.

4 / 5

Distinctiveness Conflict Risk

The PEP 8 / type hints / idioms niche is clearly Python-specific and mostly distinct, with only minor overlap risk against general code-review or linting skills. It is not a 5 because the broad "best practices for building... Python applications" tail could overlap with other Python development skills.

4 / 5

Total

14

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (751 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

valeriibeck-star/claude-skills

Path

skills/python-patterns/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.