CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

azure-storage

Azure Storage Services including Blob Storage, File Shares, Queue Storage, Table Storage, and Data Lake. Answers questions about storage access tiers (hot, cool, cold, archive), when to use each tier, and tier comparison. Provides object storage, SMB file shares, async messaging, NoSQL key-value, and big data analytics. Includes lifecycle management. USE FOR: blob storage, file shares, queue storage, table storage, data lake, upload files, download blobs, storage accounts, access tiers, storage tiers, hot cool cold archive, storage tier comparison, when to use storage tiers, lifecycle management, Azure Storage concepts. DO NOT USE FOR: SQL databases, Cosmos DB (use azure-prepare), messaging with Event Hubs or Service Bus (use azure-messaging).

Quality

86%

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

75%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 well-structured reference skill: token-efficient tables, executable CLI fallback, a clear MCP-preferred-to-CLI-fallback path, and verified one-level-deep SDK references. The deductions are minor and consistent — a duplicated SDK pointer section, missing MCP invocation parameters, and an orphaned auth-best-practices.md reference.

Suggestions

Merge the trailing 'Azure SDKs' section into 'SDK Quick References' — both point to references/sdk-usage.md, so one pointer suffices.

Add a one-line MCP invocation example showing how parameters (account, container) are passed to azure__storage commands, since that is the preferred path but currently only command names are given.

Link references/auth-best-practices.md from the body (e.g., a short 'Authentication' section or a pointer next to the MCP/CLI sections) so the existing bundle content is discoverable, and add a brief error-recovery note for failed MCP/CLI calls.

DimensionReasoningScore

Conciseness

The body is largely lean: dense tables for services, MCP commands, tiers, and redundancy, plus a compact CLI block, with no over-explanation of concepts Claude already knows. It falls short of the 5 anchor because of a redundant trailing 'Azure SDKs' section (lines 98-100) that re-points to the same references/sdk-usage.md already linked in 'SDK Quick References' (line 96), and the services table's CLI column partially repeats the CLI Fallback block — minor over-content that could be trimmed.

4 / 5

Actionability

The CLI Fallback block is copy-paste ready ('az storage blob download --account-name ACCOUNT --container-name CONTAINER --name BLOB --file LOCAL_PATH') covering list/download/upload, and MCP commands are enumerated by name. It sits at 4 rather than 5 because the MCP section names tools and commands ('azure__storage with command storage_blob_list') but never shows an invocation example or the parameters an actual call requires (e.g., how account/container are passed), leaving a minor gap on the preferred path.

4 / 5

Workflow Clarity

The decision flow is clear: MCP is labeled '(Preferred)', the five MCP commands are listed in order, and the 'If Azure MCP is not enabled' paragraph gives an explicit fallback instruction for each host plus a CLI fallback section. This satisfies anchor 4's 'clear sequence with most checkpoints'. It is not 5 because there is no error-recovery guidance (e.g., auth or not-found failures) — notably references/auth-best-practices.md exists in the bundle but is never linked — and no validation for the upload/put operations, though as a reference/lookup skill it needs less than a procedural one.

4 / 5

Progressive Disclosure

Good structure: SKILL.md is an overview (service table, tier tables, commands) with one-level-deep, clearly labeled per-service/per-language references (all 11 references/sdk/*.md files and references/sdk-usage.md verified to exist). It falls short of the 5 anchor due to minor organization gaps: references/auth-best-practices.md is present in the bundle but never referenced or navigable from SKILL.md, and sdk-usage.md is pointed to twice from two sections.

4 / 5

Total

16

/

20

Passed

Description

95%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 strong description: third-person voice, comprehensive and natural trigger terms with synonyms, explicit USE FOR/DO NOT USE boundaries, and redirects that deconflict against sibling Azure skills. The only weakness is that capabilities are stated as service descriptions rather than action verbs, leaving specificity just short of the top anchor.

DimensionReasoningScore

Specificity

The description names concrete capabilities ('Answers questions about storage access tiers (hot, cool, cold, archive), when to use each tier, and tier comparison', 'Provides object storage, SMB file shares, async messaging, NoSQL key-value, and big data analytics', 'Includes lifecycle management') covering all five services. It falls just below the 5 anchor because capabilities are phrased as service descriptions ('Provides...') rather than the concrete actions the top anchor exemplifies, while exceeding anchor 4's 'minor gaps in coverage' by spanning every service plus tiering and lifecycle.

4 / 5

Completeness

It explicitly answers 'what' (services and capabilities: object storage, SMB file shares, async messaging, NoSQL key-value, big data analytics, lifecycle management) and 'when' via a dedicated 'USE FOR:' clause with concrete trigger phrases, plus a 'DO NOT USE FOR:' exclusion clause. This matches the 5 anchor ('clearly and explicitly answers both what AND when with concrete trigger phrases') and clearly exceeds anchor 4, whose 'when' is less explicit.

5 / 5

Trigger Term Quality

The USE FOR list is comprehensive and natural: 'blob storage, file shares, queue storage, table storage, data lake, upload files, download blobs, storage accounts, access tiers, storage tiers, hot cool cold archive, storage tier comparison, when to use storage tiers, lifecycle management, Azure Storage concepts'. It includes synonyms ('access tiers' and 'storage tiers'), user-phrased actions ('upload files', 'download blobs'), and question-style triggers ('when to use storage tiers'), matching the 5 anchor's comprehensive synonym coverage.

5 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (Azure Storage) with distinct triggers and an explicit conflict-avoidance clause routing adjacent domains to sibling skills: 'DO NOT USE FOR: SQL databases, Cosmos DB (use azure-prepare), messaging with Event Hubs or Service Bus (use azure-messaging)'. Minimal conflict risk, matching the 5 anchor.

5 / 5

Total

19

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 11 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 11 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

microsoft/azure-skills

Path

.github/plugins/azure-skills/skills/azure-storage/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.