Pythonic 惯用法、PEP 8 标准、类型提示以及构建健壮、高效、可维护的 Python 应用程序的最佳实践。
Install with Tessl CLI
npx tessl i github:haniakrim21/everything-claude-code --skill python-patternsOverall
score
61%
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillValidation for skill structure
Discovery
33%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 description identifies the Python domain and mentions specific standards (PEP 8, type hints) but reads more like a topic list than an actionable skill description. The critical weakness is the complete absence of trigger guidance ('Use when...'), making it difficult for Claude to know when to select this skill over others. The description also lacks concrete action verbs describing what the skill enables.
Suggestions
Add an explicit 'Use when...' clause with trigger scenarios like 'Use when reviewing Python code, writing new Python modules, or when the user asks about Python style, type annotations, or code quality'
Include concrete actions the skill performs, such as 'Reviews Python code for style compliance, suggests type annotations, refactors code to follow Pythonic patterns'
Add common trigger terms users would naturally say: 'Python code review', 'code style', 'linting', '.py files', 'Python formatting'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Python) and mentions some specific concepts like 'PEP 8 standards', 'type hints', and 'Pythonic idioms', but doesn't list concrete actions - it describes qualities/standards rather than what the skill actually does. | 2 / 3 |
Completeness | Describes what the skill covers (Python standards and 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' that users might mention, but misses common variations like 'Python code', 'linting', 'code style', 'formatting', '.py files', or 'Python best practices'. | 2 / 3 |
Distinctiveness Conflict Risk | Python-specific focus provides some distinction, but 'best practices' and 'maintainable applications' are generic enough to potentially overlap with general coding skills or other language-specific skills. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
65%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, executable code examples covering idiomatic Python practices. The main weaknesses are verbosity (explaining concepts Claude already knows) and the monolithic structure that could benefit from progressive disclosure through linked sub-documents. The actionability is strong, making this immediately useful for Python development tasks.
Suggestions
Remove explanatory prose that states obvious concepts (e.g., 'Python prioritizes readability', 'Avoid magic') - let the code examples speak for themselves
Split into multiple files (TYPING.md, CONCURRENCY.md, PATTERNS.md) with SKILL.md as a concise overview linking to detailed references
Add a workflow section for the tool integration commands showing the recommended order and when to run each tool (e.g., 'Before commit: black -> isort -> ruff -> mypy')
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is comprehensive but includes some unnecessary explanations that Claude already knows (e.g., explaining what EAFP means, basic concepts like 'Python prioritizes readability'). Some sections could be tightened, though the code examples themselves are efficient. | 2 / 3 |
Actionability | Excellent executable code examples throughout - all snippets are copy-paste ready with proper imports, type hints, and realistic use cases. The examples cover both good and bad patterns with clear contrast. | 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 tool integration section lists commands without explaining when to use each or in what order, and lacks validation checkpoints for the 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 into separate files (e.g., CONCURRENCY.md, TYPING.md, PATTERNS.md) with the main skill providing an overview and links. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
91%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (750 lines); consider splitting into references/ and linking | Warning |
Total | 10 / 11 Passed | |
Table of Contents
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.