CtrlK
BlogDocsLog inGet started
Tessl Logo

python-style

Python coding style enforcement (PEP standards, type hints, docstrings, modern patterns). Auto-loads when writing or reviewing Python code.

62

Quality

73%

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/python-experts/skills/python-style/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

76%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 content is highly actionable with executable, copy-paste-ready examples and is well sectioned, but it runs slightly long with a few inferable rationale paragraphs and omits a validation checkpoint before its batch ruff auto-fix commands.

Suggestions

Add a validation checkpoint to the ruff workflow: run `ruff check .` (without --fix) to review findings, apply fixes, then verify the diff and run tests before committing.

Trim inferable rationale such as the 'Why This Matters' section and the sentence explaining that consistent import ordering enables clean merges.

Consider moving the detailed 'Merge-Friendly Patterns' section into a reference file (e.g. references/merge-friendly.md) referenced one level deep from SKILL.md.

DimensionReasoningScore

Conciseness

The body is dense and largely avoids lecturing about Python basics, but rationale restatements like 'This ensures imports are consistently ordered, enabling clean merges' and the 'Why This Matters' section are mild over-explanation Claude could infer.

4 / 5

Actionability

Copy-paste-ready code blocks (naming, type hints, correct/wrong __all__) and concrete commands ('uv run ruff format .', 'uv run ruff check --fix .') plus a TOML snippet enabling RUF022 cover the common cases fully.

5 / 5

Workflow Clarity

The 'When Adding to Shared Files' section gives a coherent numbered sequence, but the batch file mutations 'ruff check --fix .' and 'ruff format .' have no validation gate (e.g. review the diff, run tests), so the destructive/batch cap of 3 applies.

3 / 5

Progressive Disclosure

No bundle files exist and the body is well organized with clear section headers; the detailed 'Merge-Friendly Patterns' subsection is beyond the under-50-line simple-skill exception and could be externalized, keeping it at 4 rather than 5.

4 / 5

Total

16

/

20

Passed

Description

70%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 clearly identifies the skill's domain and scope and provides explicit trigger guidance, but it leans on the generic action 'enforcement' rather than enumerating concrete enforcement actions, and its trigger terms lack common synonyms.

Suggestions

Replace the generic verb 'enforcement' with concrete actions the skill performs, e.g. 'enforces alphabetical __all__, formats imports, checks function length, and applies PEP 8 naming'.

Add a 'Use when...' clause with natural trigger phrases and synonyms such as 'writing or reviewing Python, .py files, Python scripts, or PEP 8 / type-hint compliance'.

Tighten the 'when' trigger to reduce overlap with general Python skills, e.g. scope it to style/linting reviews rather than all Python writing.

DimensionReasoningScore

Specificity

Names the domain and enumerates scope ('PEP standards, type hints, docstrings, modern patterns') but the only action verb is the generic 'enforcement'; no concrete enforcement actions are listed, so it sits at the domain-plus-enumeration level rather than comprehensive.

3 / 5

Completeness

Both 'what' (style enforcement) and 'when' ('Auto-loads when writing or reviewing Python code') are present with explicit trigger guidance, but the trigger phrasing is framed as an auto-load mechanism rather than rich concrete trigger phrases.

4 / 5

Trigger Term Quality

'writing or reviewing Python code' provides two genuinely natural user phrasings and 'Python code' is a common trigger term, though synonyms like '.py files', 'Python scripts', 'PEP 8', 'linting', or 'ruff' are absent.

4 / 5

Distinctiveness Conflict Risk

Python-specific style enforcement is a fairly clear niche, but 'writing or reviewing Python code' is broad enough to overlap with general-purpose Python skills, preventing a clear-distinctive 5.

4 / 5

Total

15

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
jpoutrin/product-forge
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.