Execute use when detecting infrastructure drift from desired state. Trigger with phrases like "check for drift", "infrastructure drift detection", "compare actual vs desired state", or "detect configuration changes". Identifies discrepancies between current infrastructure and IaC definitions using terraform plan, cloudformation drift detection, or manual comparison.
62
75%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/devops/infrastructure-drift-detector/skills/detecting-infrastructure-drift/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 well-crafted skill description that clearly defines its purpose, provides explicit trigger phrases, and names specific tools and actions. It covers the what/when comprehensively and occupies a distinct niche. The only minor issue is the slightly awkward opening 'Execute use when detecting...' which could be cleaner, but it doesn't materially impact functionality.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Identifies discrepancies between current infrastructure and IaC definitions', 'using terraform plan, cloudformation drift detection, or manual comparison'. These are concrete, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both 'what' (identifies discrepancies between current infrastructure and IaC definitions using specific tools) and 'when' (explicit trigger phrases like 'check for drift', 'infrastructure drift detection', etc.). Has an explicit 'Trigger with phrases like...' clause. | 3 / 3 |
Trigger Term Quality | Includes strong natural trigger terms: 'check for drift', 'infrastructure drift detection', 'compare actual vs desired state', 'detect configuration changes', plus tool-specific terms like 'terraform plan', 'cloudformation drift detection'. These are phrases users would naturally say. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive niche focused specifically on infrastructure drift detection. The combination of IaC-specific terminology (terraform plan, cloudformation, drift detection) and the narrow use case makes it very unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides a reasonable overview of infrastructure drift detection with useful commands and a helpful error handling table, but falls short on actionability — key steps like parsing output, generating reports, and setting up CI pipelines are described abstractly rather than with executable code. The workflow lacks validation checkpoints after remediation and clear decision branching. The content could be tightened by removing the vague 'Examples' section and the 'Output' wishlist, replacing them with concrete, executable workflows.
Suggestions
Add executable code examples for parsing terraform plan output and generating the structured drift report (e.g., a script or jq commands to extract drifted resources).
Add a validation checkpoint after remediation: re-run `terraform plan` to confirm zero drift after applying fixes, with a feedback loop if drift persists.
Replace the vague 'Examples' bullet points with concrete input/output examples showing actual terraform plan output and the expected drift report format.
Remove or condense the 'Output' section — it reads as a deliverables wishlist rather than actionable instruction. Fold key output format requirements into the instructions themselves.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill includes some unnecessary content like the 'Examples' section with vague prompt descriptions rather than executable examples, the 'Resources' section with URLs, and the 'Output' section that describes deliverables rather than instructing. The prerequisites section explains things Claude could infer. However, the core instructions and error handling table are reasonably efficient. | 2 / 3 |
Actionability | Provides specific commands like `terraform plan -detailed-exitcode` and `aws cloudformation detect-stack-drift`, and the error handling table has concrete solutions. However, there are no executable code blocks showing how to parse drift output, generate the structured report, or set up the CI pipeline. Steps 5-9 are abstract guidance rather than concrete, executable instructions. | 2 / 3 |
Workflow Clarity | Steps are sequenced logically from identification through remediation, but there are no explicit validation checkpoints or feedback loops. Steps 5-9 are vague and lack clear decision criteria. There's no 'if drift detected, do X; if no drift, do Y' branching, and no verification step after remediation to confirm drift is resolved. | 2 / 3 |
Progressive Disclosure | The content is organized into clear sections (Prerequisites, Instructions, Output, Error Handling, Examples, Resources), which is good structure. However, it's somewhat monolithic — the error handling table, output specifications, and resource links could be in separate files. No bundle files exist to offload detail, and the skill is moderately long without clear navigation to deeper content. | 2 / 3 |
Total | 8 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
69c73e9
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.