CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

azure-storage-file-datalake-py

Azure Data Lake Storage Gen2 SDK for Python. Use for hierarchical file systems, big data analytics, and file/directory operations.

Quality

76%

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/AI-Agents-Safe-Coding-Skills/skills/azure-storage-file-datalake-py/SKILL.md

The canonical home for this skill is azure-storage-file-datalake-py in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

72%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 highly actionable, code-first reference with excellent executable coverage of the SDK's surface. Its weaknesses are the inline monolithic layout (~200 lines of API reference with no reference files), absent validation guidance around destructive and recursive batch operations, and a small amount of filler and duplicated setup code.

Suggestions

Add validation steps around destructive and batch operations, e.g., 'Before delete_file/delete_directory, list paths with get_paths() to confirm the target; after update_access_control_recursive, re-read get_access_control() to verify entries' — this would lift workflow clarity past its current cap of 3.

Split the ACL and async-client sections into references/ files (e.g., references/acl.md, references/async.md) and link them from a shorter SKILL.md overview, moving progressive disclosure toward one-level-deep references.

Remove the filler 'When to Use' sentence and the repeated client-setup lines between sections to tighten token efficiency.

DimensionReasoningScore

Conciseness

The body is dominated by executable code with almost no conceptual padding — no explanations of what Data Lake is or how the library works — matching 'Efficient; minor instances of over-explanation that could be trimmed'. Not a 5: the closing 'When to Use' line ('This skill is applicable to execute the workflow or actions described in the overview.') is pure filler, and client setup is redundantly repeated across sections.

4 / 5

Actionability

Every section is copy-paste-ready executable code: the exact pip install, DefaultAzureCredential authentication, complete upload/download/list/ACL/async snippets with realistic arguments and correct offsets (e.g., append_data at offset 6, flush_data(12)). This matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

The document is organized by operation type rather than as a workflow, and its destructive and batch operations — delete_file_system, delete_directory, delete_file, and update_access_control_recursive — have no validation or verification steps (e.g., check existence before delete, verify ACL results). Per the rubric cap, destructive/batch operations without validation cap this at 3; the sequence that exists is per-operation and unambiguous, so it is not below 3.

3 / 5

Progressive Disclosure

There are no bundle files (references/, scripts/, assets/ all absent), so everything lives inline in SKILL.md: roughly 200 lines of API reference (full operation catalog, ACL details, async client) directly matching the level-3 anchor 'content that should be separate is inline'. Section headers are clear, which keeps it above the level-2 anchor, but the advanced material (ACL, async) could be split into reference files to reach level 4.

3 / 5

Total

15

/

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 solid, concise description with a clear product niche and an explicit 'Use for' trigger clause. Its main weaknesses are generic action phrasing ('file/directory operations') instead of concrete capabilities, and missing natural synonyms like 'ADLS' or 'data lake'.

Suggestions

Replace the generic 'file/directory operations' with concrete capabilities, e.g., 'Create file systems, upload and download files, manage directories, and set access control (ACLs) on Azure Data Lake Storage Gen2'.

Add natural trigger synonyms users actually say: 'Use when the user mentions ADLS, ADLS Gen2, data lake, or Gen2 storage accounts in Python'.

Add a distinguishing cue against Azure Blob storage (e.g., 'Use the hierarchical-namespace Gen2 API, not the flat Blob API') to reduce overlap risk with a potential azure-blob skill.

DimensionReasoningScore

Specificity

The description names the domain clearly ('Azure Data Lake Storage Gen2 SDK for Python') and lists functional areas ('hierarchical file systems, big data analytics, and file/directory operations'), but 'file/directory operations' is generic — no concrete actions like create file systems, upload/download files, or manage ACLs are stated. It fits the anchor 'Names domain and 1-2 concrete actions, but not comprehensive' better than the level-4 anchor, which expects several specific listed actions.

3 / 5

Completeness

Both parts are present: 'what' via 'Azure Data Lake Storage Gen2 SDK for Python' plus functional areas, and an explicit trigger clause 'Use for hierarchical file systems, big data analytics, and file/directory operations', so the missing-'Use when' cap at 3 does not apply. Not a 5 because the 'when' lacks concrete trigger phrases (e.g., 'when the user mentions ADLS Gen2 or data lakes') and the 'what' describes identity more than actions — matching the level-4 anchor where 'when' could be more explicit or specific.

4 / 5

Trigger Term Quality

Good keyword coverage including the exact product name, 'Python', 'hierarchical file systems', 'big data analytics', and 'file/directory operations' — natural terms for this need. A few natural variations are missing (e.g., 'ADLS', 'ADLS Gen2', 'data lake' as a standalone phrase), matching the level-4 anchor 'Good keyword coverage; a few natural terms missing' rather than the comprehensive level-5 anchor.

4 / 5

Distinctiveness Conflict Risk

The 'Azure Data Lake Storage Gen2' niche is clear and product-specific with distinct triggers. Minor overlap risk remains with closely related skills — ADLS Gen2 sits on top of Azure Blob Storage (the body itself says 'Consider Blob API'), and 'file/directory operations' could also fire for generic filesystem skills — matching the level-4 anchor 'Mostly distinct; minor overlap risk with closely related skills'.

4 / 5

Total

15

/

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/AI-Agents-Safe-Coding-Skills/skills/azure-storage-file-datalake-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.