CtrlK
BlogDocsLog inGet started
Tessl Logo

azure-compliance

Run Azure compliance and security audits with azqr plus Key Vault expiration checks. Covers best-practice assessment, resource review, policy/compliance validation, and security posture checks. WHEN: compliance scan, security audit, BEFORE running azqr (compliance cli tool), Azure best practices, Key Vault expiration check, expired certificates, expiring secrets, orphaned resources, compliance assessment.

77

Quality

71%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugin/skills/azure-compliance/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong skill description that clearly communicates specific capabilities (Azure compliance audits via azqr, Key Vault expiration checks), provides comprehensive trigger terms in an explicit WHEN clause, and occupies a distinct niche. The description is concise, uses third-person voice, and covers both what the skill does and when it should be selected.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'Run Azure compliance and security audits with azqr', 'Key Vault expiration checks', 'best-practice assessment', 'resource review', 'policy/compliance validation', 'security posture checks'. These are concrete, identifiable tasks.

3 / 3

Completeness

Clearly answers both 'what' (run Azure compliance/security audits with azqr, Key Vault expiration checks, best-practice assessment, resource review, policy/compliance validation, security posture checks) and 'when' with an explicit 'WHEN:' clause listing trigger scenarios like 'compliance scan', 'security audit', 'BEFORE running azqr', etc.

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'compliance scan', 'security audit', 'Azure best practices', 'Key Vault expiration check', 'expired certificates', 'expiring secrets', 'orphaned resources', 'compliance assessment', and the tool name 'azqr'. These are terms a user would naturally use when requesting these tasks.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche: Azure-specific compliance and security auditing using the azqr tool, plus Key Vault expiration checks. The combination of Azure, azqr, Key Vault, and compliance/security terms creates a very specific domain unlikely to conflict with other skills.

3 / 3

Total

12

/

12

Passed

Implementation

42%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The skill is well-organized as a navigation hub with good progressive disclosure to reference files, but critically lacks actionable, executable guidance. The workflow is too abstract with no concrete MCP tool invocation examples, no sample outputs, and no validation checkpoints. It reads more like a table of contents than an instructional skill.

Suggestions

Add concrete MCP tool invocation examples showing exact parameters, e.g., how to call `mcp_azure_mcp_extension_azqr` with specific subscription/resource group arguments and what the output looks like.

Include a complete worked example showing the end-to-end flow: listing subscriptions, running azqr on one, checking Key Vault expiration, and classifying a finding.

Add explicit validation checkpoints in the workflow, e.g., 'Verify azqr completed successfully by checking for output artifacts before proceeding to analysis' with specific checks.

Remove or consolidate the overlapping 'When to Use This Skill' and 'Skill Activation Triggers' sections to reduce redundancy.

DimensionReasoningScore

Conciseness

The skill includes some unnecessary sections like 'Skill Activation Triggers' which extensively lists things Claude can infer, and the 'When to Use This Skill' section overlaps significantly with triggers. The tables are reasonably efficient but there's redundancy between sections. The 'Best Practices' section states obvious guidance Claude already knows.

2 / 3

Actionability

The skill provides no executable code, no concrete commands, and no specific examples of how to call the MCP tools or interpret results. The workflow is entirely abstract ('Run azqr and capture output artifacts') with no actual invocation syntax or example outputs. It describes rather than instructs.

1 / 3

Workflow Clarity

The 5-step assessment workflow provides a sequence but lacks validation checkpoints, feedback loops, and concrete details. There's no explicit verification step after running azqr, no guidance on what to do if scans fail mid-process, and the steps are too high-level to be reliably followed. The error handling table partially compensates but is disconnected from the workflow.

2 / 3

Progressive Disclosure

The skill is well-structured as an overview with clear one-level-deep references to detailed materials (azure-quick-review.md, azure-keyvault-expiration-audit.md, azure-resource-graph.md, and SDK guides). Navigation is easy with well-organized tables pointing to specific reference files.

3 / 3

Total

8

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
microsoft/github-copilot-for-azure
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.