CtrlK
BlogDocsLog inGet started
Tessl Logo

detecting-infrastructure-drift

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

Quality

75%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/devops/infrastructure-drift-detector/skills/detecting-infrastructure-drift/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 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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

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

Repository
jeremylongshore/claude-code-plugins-plus-skills
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.