CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

readable-py

Readable Python code rules inspired by The Art of Readable Code. Use when writing, reviewing, or refactoring Python code. Enforces short functions, flat control flow, clear naming, readable structure, and Pythonic idioms.

Quality

87%

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

88%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 strong, highly actionable rulebook: concrete thresholds and executable good/bad examples make every rule immediately applicable. The only notable gaps are mild redundancy with knowledge Claude already has and a monolithic single-file structure that could offload extended examples to reference files.

DimensionReasoningScore

Conciseness

Rules are stated densely with specific thresholds ('Never nest more than 2 levels deep', 'Aim for 3 or fewer arguments', '15-25 lines') rather than padded prose. A few rules restate knowledge Claude already has (early returns, magic numbers, enumerate/zip, pathlib), which is minor over-explanation — anchor 4, not 5.

4 / 5

Actionability

Every rule is concrete and checkable, with executable good/bad code examples (get_active_users, resolve_setting, comprehension patterns) covering the common cases. This matches anchor 5: copy-paste-ready, specific examples throughout.

5 / 5

Workflow Clarity

This is a single-purpose ruleset skill: the one action — apply these rules when writing, reviewing, or refactoring Python — is unambiguous, and there are no destructive or batch operations requiring validation checkpoints. Under the simple-skill exception the unambiguous single action scores 5.

5 / 5

Progressive Disclosure

Well-organized numbered sections with a clear general-rules/Python-specific split, but the ~210-line body keeps everything inline in SKILL.md. Beyond the under-50-lines bar for a 5, and the extended formatter/comprehension examples could reasonably live in a reference file — matching anchor 4 ('good structure; most content appropriately placed') rather than 2's clearly-misplaced inlining.

4 / 5

Total

18

/

20

Passed

Description

80%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 well-constructed description with an explicit what-and-when structure and natural trigger phrasing. Its main weakness is breadth: the trigger covers virtually all Python work, so it risks firing in place of or alongside more specialized Python style, lint, or review skills.

Suggestions

Narrow the trigger to readability-focused moments (e.g., 'Use when writing, reviewing, or refactoring Python code where readability, clean code, or maintainability matters') to reduce overlap with general Python and code-review skills.

Add common user synonyms such as 'clean code', 'code smells', 'PEP 8', or 'readability' to the trigger clause to improve keyword coverage.

State the concrete output when reviewing (e.g., 'flags violations and suggests refactors') to sharpen the specificity of capabilities.

DimensionReasoningScore

Specificity

'Enforces short functions, flat control flow, clear naming, readable structure, and Pythonic idioms' lists several specific capability areas with only minor gaps (e.g., it never says what output a review produces). It is more comprehensive than anchor 3 but falls short of anchor 5's full concrete action inventory.

4 / 5

Completeness

The 'what' is explicit ('Readable Python code rules... Enforces short functions, flat control flow, clear naming, readable structure, and Pythonic idioms') and the 'when' is an explicit 'Use when writing, reviewing, or refactoring Python code' clause with concrete trigger phrases. Both halves are clearly and explicitly answered, matching anchor 5 rather than 4 where the when-clause could be more specific.

5 / 5

Trigger Term Quality

'Use when writing, reviewing, or refactoring Python code' provides natural phrases users would say, and 'Readable Python code rules' names the domain directly. Common synonyms like 'clean code', 'code smells', 'PEP 8', or 'readability' are missing, so it matches anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

The trigger 'writing, reviewing, or refactoring Python code' fires on essentially any Python task, creating real overlap risk with general Python style, linting, and code-review skills. It is more specific than anchor 2's 'Helps with document files' but only somewhat distinct, matching anchor 3.

3 / 5

Total

16

/

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

crazyguitar/pysheeet

Path

skills/readable-py/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.