CtrlK
BlogDocsLog inGet started
Tessl Logo

python-patterns

Pythonic 惯用法、PEP 8 标准、类型提示以及构建健壮、高效、可维护的 Python 应用程序的最佳实践。

65

1.17x
Quality

48%

Does it follow best practices?

Impact

94%

1.17x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./docs/zh-CN/skills/python-patterns/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

32%

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 the Python domain and mentions relevant standards (PEP 8, type hints) but lacks concrete action verbs and completely omits trigger guidance. It reads more like a topic list than an actionable skill description, making it difficult for Claude to know precisely when to select this skill over others.

Suggestions

Add a 'Use when...' clause with explicit triggers like 'Use when reviewing Python code, applying PEP 8 formatting, adding type annotations, or refactoring for Pythonic style'

Replace abstract nouns with concrete action verbs: 'Reviews Python code for PEP 8 compliance, adds type hints, refactors to Pythonic idioms'

Include common user phrases and file extensions: 'Python code', '.py files', 'code review', 'linting', 'style check'

DimensionReasoningScore

Specificity

Names the domain (Python) and mentions some concepts like 'Pythonic idioms', 'PEP 8 standards', 'type hints', and 'best practices', but these are categories rather than concrete actions. No specific verbs describing what the skill does.

2 / 3

Completeness

Describes 'what' at a high level (Python best practices) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill.

1 / 3

Trigger Term Quality

Contains relevant keywords like 'Python', 'PEP 8', 'type hints' (类型提示), but missing common variations users might say like 'Python code review', 'linting', 'code style', 'refactor', or file extensions like '.py'.

2 / 3

Distinctiveness Conflict Risk

Python-specific which helps, but 'best practices' and 'maintainable applications' are broad enough to potentially overlap with general coding skills or other Python-related skills.

2 / 3

Total

7

/

12

Passed

Implementation

64%

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 Python patterns reference with excellent actionability - nearly all examples are executable and practical. The main weaknesses are verbosity (explaining concepts Claude knows) and the monolithic structure that could benefit from progressive disclosure to separate files. The content would be more effective as a concise overview linking to detailed pattern files.

Suggestions

Remove explanatory prose that states obvious Python philosophy (e.g., 'Python prioritizes readability', 'Avoid magic') - Claude knows these concepts

Split into multiple files: keep core patterns in SKILL.md, move advanced topics (concurrency, decorators, package organization) to linked reference files

Add a workflow section for common development tasks with explicit validation steps (e.g., 'Before committing: 1. Run black, 2. Run ruff --fix, 3. Run mypy, 4. Run pytest')

DimensionReasoningScore

Conciseness

The skill is comprehensive but includes some explanatory text that Claude already knows (e.g., 'Python prioritizes readability', 'Python prefers exceptions over checking conditions'). The code examples are good but could be more concise by removing obvious comments and reducing redundant explanations.

2 / 3

Actionability

Excellent actionability with fully executable, copy-paste ready code examples throughout. Each pattern includes concrete Python code with proper imports, type hints, and usage examples. The bash commands and pyproject.toml configuration are directly usable.

3 / 3

Workflow Clarity

This is primarily a reference/patterns skill rather than a workflow skill, so multi-step processes are less relevant. However, the 'Python Tooling Integration' section lists commands without clear sequencing or validation steps for when to use each tool in a development workflow.

2 / 3

Progressive Disclosure

The content is well-organized with clear sections and a quick reference table, but it's a monolithic document (~500 lines) that could benefit from splitting advanced topics (concurrency, decorators, package organization) into separate reference files with links from the main skill.

2 / 3

Total

9

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

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

Warning

Total

10

/

11

Passed

Repository
haniakrim21/everything-claude-code
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.