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
71%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.github/plugins/azure-skills/skills/azure-compliance/SKILL.mdQuality
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 covering natural user language, and explicitly separates 'what' from 'when'. The description is distinctive enough to avoid conflicts with other skills while being concise and well-structured.
| Dimension | Reasoning | Score |
|---|---|---|
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 users 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 auditing 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 excels at progressive disclosure and organization, serving as a clear hub pointing to detailed reference materials. However, it critically lacks actionability—there are no concrete tool invocation examples, no sample commands, and no expected output formats. The workflow is too abstract to guide Claude through actual compliance scanning without relying entirely on the referenced files.
Suggestions
Add concrete MCP tool invocation examples showing how to call azqr and Key Vault inspection tools with actual parameters (e.g., `mcp_azure_mcp_extension_azqr` with subscription_id and expected output format).
Include at least one complete worked example showing the flow from listing subscriptions → running azqr → interpreting a sample finding → classifying priority.
Add a validation checkpoint in the workflow (e.g., 'Verify azqr completed successfully and output contains expected sections before proceeding to analysis').
Remove or consolidate the redundant 'When to Use This Skill' and 'Skill Activation Triggers' sections into a single concise trigger list.
| Dimension | Reasoning | Score |
|---|---|---|
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 largely duplicates the triggers. The tables are reasonably efficient but there's redundancy between sections. | 2 / 3 |
Actionability | The skill provides no executable code, no concrete commands, and no specific examples of how to actually run azqr or query Key Vault expiration. The workflow is entirely abstract ('Run azqr and capture output artifacts') with no concrete tool invocation patterns or example outputs. | 1 / 3 |
Workflow Clarity | The 5-step assessment workflow provides a sequence but lacks validation checkpoints and feedback loops. For a compliance/security audit involving potentially destructive remediation recommendations, there are no explicit verification steps between scanning and proposing fixes. | 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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
9d594ab
Table of Contents
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.