CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

auto-import-rules

Enforces dlt import conventions and ordering. Use when writing or modifying Python imports in dlt/ or tests/.

Quality

69%

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 ./.claude/skills/auto-import-rules/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

53%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 maximally lean but functionally hollow: it is a one-line pointer to @.claude/rules/imports.md, a file that is not shipped in the bundle, so the skill delivers no usable import guidance on its own. The cryptic qualifier 'regardless of path setting' further obscures the intended workflow.

Suggestions

Ship the import rules inside the skill (e.g., a references/imports.md listed in the bundle) or inline the key ordering rules directly in the body, so the pointer resolves to real content.

Clarify or remove 'regardless of path setting' — state plainly when the rules apply (e.g., 'Apply to all Python files in dlt/ and tests/, including test helpers') so the single action is unambiguous.

Add a short example of correct vs. incorrect import ordering so the skill remains actionable even if the referenced file is unavailable.

DimensionReasoningScore

Conciseness

The body is a single line with zero padding and no explanation of concepts Claude already knows — every token earns its place, matching the 'lean and efficient' anchor exactly. It cannot score higher and does not risk a lower anchor on a one-line body.

5 / 5

Actionability

"Use @.claude/rules/imports.md" points at a specific file, but that file is not in the bundle and does not exist, so no executable import rules are actually delivered — 'minimal concrete guidance; missing the specific steps to execute' (anchor 2). It is above anchor 1 because the directive is specific rather than abstract, but below anchor 3 because there is no partially-complete executable guidance at all.

2 / 5

Workflow Clarity

It is a single-action skill, but the action is not unambiguous ("regardless of path setting" is cryptic) and the workflow dead-ends at a missing file, so the simple-skill exception to score 5 does not apply. This lands at anchor 3: a stated step whose follow-through is broken.

3 / 5

Progressive Disclosure

The sole reference is clearly signaled but points outside the skill bundle to a nonexistent path, leaving a broken, structureless stub — anchor 2 ('minimal structure'). It is not anchor 1 because there is no nested-reference chain, and not anchor 3 because there are no valid references or own sections to organize.

2 / 5

Total

12

/

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.

A compact, well-formed description with an explicit 'Use when' trigger and clear niche scoping. Its main weakness is that the capability side stays abstract — 'conventions and ordering' — without naming any of the actual rules it enforces.

Suggestions

Name one or two of the concrete conventions enforced (e.g., import grouping, isort-style ordering, relative-import rules) so the 'what' is specific rather than abstract.

Add a synonym or two users naturally say, such as 'import statements' or 'fixing imports', to broaden trigger coverage.

DimensionReasoningScore

Specificity

"Enforces dlt import conventions and ordering" names the domain and two actions but never states what the conventions actually are, matching the anchor 'names domain and 1-2 concrete actions, but not comprehensive'. It falls short of 4 because no list of several specific actions is given.

3 / 5

Completeness

Both are present: what ("Enforces dlt import conventions and ordering") and an explicit when ("Use when writing or modifying Python imports in dlt/ or tests/"). The 'what' is thin since the conventions themselves are unspecified, keeping it at anchor 4 rather than 5.

4 / 5

Trigger Term Quality

"writing or modifying Python imports", "dlt/", and "tests/" are natural phrases a user would say, giving good coverage; common synonyms like "import statements" or "isort" are missing, so it does not reach the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

The dlt-specific niche and path scoping ("dlt/ or tests/") make it mostly distinct, but the broad phrase "Python imports" carries minor overlap risk with generic lint/format skills, matching anchor 4 rather than the minimal-conflict anchor 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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

dlt-hub/dlt

Path

.claude/skills/auto-import-rules/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.