CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

python-patterns

Python development principles and decision-making. Framework selection, async patterns, type hints, project structure. Teaches thinking, not copying.

Quality

64%

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 ./plugins/antigravity-bundle-python-pro/skills/python-patterns/SKILL.md

The canonical home for this skill is python-patterns in administrakt0r/AI-Agents-Safe-Coding-Skills

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-sectioned and offers concrete decision aids (trees, tables, checklists), but much of it restates standard Python/Django knowledge Claude already has, and it is a monolithic single file with no progressive disclosure. A decision checklist exists but lacks validation checkpoints.

Suggestions

Cut sections that restate knowledge Claude already has (framework one-liners, the async golden rule, select_related/prefetch_related, N+1 advice) and keep only the decision framing and genuinely non-obvious guidance.

Split framework-specific deep dives (Django, FastAPI, testing) into references/ files (e.g. DJANGO.md, FASTAPI.md, TESTING.md) with one-level-deep links from SKILL.md.

Move version/time-sensitive claims ('2025', 'Django 5.0+') into a dedicated current-state or deprecation section so they don't silently age.

DimensionReasoningScore

Conciseness

Large sections restate knowledge Claude already has — 'Django (batteries-included)', 'select_related() for FKs, prefetch_related() for M2M', 'Avoid N+1 queries', the I/O-bound/CPU-bound golden rule — matching anchor 2's 'noticeably verbose; several unnecessary explanations'. Not anchor 1 because the format is compact (trees/tables, no padded prose); not anchor 3 because the redundancy spans multiple sections rather than isolated instances, and unscoped time-sensitive claims ('Framework Selection (2025)', 'Django 5.0+') further cost conciseness per the guidelines.

2 / 5

Actionability

Concrete guidance dominates: a framework decision tree, comparison tables, a specific async library table (httpx, asyncpg, aiofiles), a background-task selection guide, and mostly-executable code for type hints and async testing — matching anchor 4's 'mostly executable guidance; concrete code or commands with minor gaps'. Not anchor 5 because code snippets contain '...' stubs and several sections are pure lists without copy-paste-ready examples; not anchor 3 because the guidance is genuinely concrete, not pseudocode.

4 / 5

Workflow Clarity

Section 10's 'Decision Checklist' (asked user preference? chosen framework for THIS context? decided async vs sync?) provides a pre-implementation sequence, but there are no validation checkpoints or feedback loops verifying the decisions — matching anchor 3's 'steps listed but validation gaps; checkpoints missing or implicit'. Not anchor 4 because the checkpoints that would confirm each decision are absent; not anchor 2 because a real, ordered checklist exists.

3 / 5

Progressive Disclosure

The 447-line body has no bundle files at all — Django, FastAPI, testing, and background-task deep dives that would sit naturally in separate reference files are entirely inlined, matching anchor 3's 'content that should be separate is inline'. Not anchor 2 because section headers are clear and consistent (good structure, not minimal); not anchor 4-5 because there are no well-signaled one-level-deep references and no content split across files.

3 / 5

Total

12

/

20

Passed

Description

62%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 has a clear, well-scoped 'what' with decent natural keywords, but it entirely lacks a 'Use when...' trigger clause, capping completeness. Its breadth ('Python development principles') leaves moderate conflict risk with adjacent Python-focused skills.

Suggestions

Append an explicit trigger clause, e.g. 'Use when choosing a Python web framework (FastAPI, Django, Flask), deciding async vs sync, or structuring a Python project.'

Include concrete technology names users actually say (FastAPI, Django, Flask, Pydantic, pytest) to strengthen trigger terms and distinctiveness.

Narrow the framing from broad 'Python development principles' to decision-making for Python web/services architecture to reduce overlap with general coding skills.

DimensionReasoningScore

Specificity

The description names the domain ('Python development principles and decision-making') and lists four concrete capability areas ('Framework selection, async patterns, type hints, project structure'), matching anchor 4's 'several specific actions; minor gaps in coverage' — testing, error handling, and background tasks from the body are absent. Not anchor 5 because coverage is not comprehensive; not anchor 3 because it lists four areas rather than 1-2.

4 / 5

Completeness

The 'what' is clear (principles and decision-making across framework selection, async, type hints, structure) but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. This matches anchor 3 ('clear what but when is missing or only weakly implied'); not anchor 2 because the 'what' is specific, not vague.

3 / 5

Trigger Term Quality

Natural phrases users would say are present ('Python development', 'Framework selection', 'async patterns', 'type hints', 'project structure'), fitting anchor 4's 'good keyword coverage; a few natural terms missing'. Not anchor 5 because it lacks synonyms and the specific technology names users actually mention (FastAPI, Django, Flask, Pydantic, pytest); not anchor 3 because coverage spans the full topic space rather than a couple of keywords.

4 / 5

Distinctiveness Conflict Risk

'Python development principles and decision-making' is broad and would overlap with general Python coding, code-review, and testing skills, though the named areas (frameworks, async, type hints) provide some specificity — matching anchor 3 ('somewhat specific but could still overlap with similar skills'). Not anchor 4 because the scope is not narrowed to a distinct niche with minimal conflict.

3 / 5

Total

14

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/antigravity-bundle-python-pro/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.