CtrlK
BlogDocsLog inGet started
Tessl Logo

cfn-template-compare

Compares deployed CloudFormation templates with locally synthesized CDK templates to detect drift, validate changes, and ensure consistency before deployment. Use when the user wants to compare CDK output with a deployed stack, check for infrastructure drift, run a pre-deployment validation, audit IAM or security changes, investigate a failing deployment, or perform a 'cdk diff'-style review. Triggered by phrases like 'compare templates', 'check for drift', 'cfn drift', 'stack comparison', 'infrastructure drift detection', 'safe to deploy', or 'what changed in my CDK stack'.

98

1.08x
Quality

98%

Does it follow best practices?

Impact

100%

1.08x

Average score across 5 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

96%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 strong, highly actionable skill body: executable commands throughout, a well-sequenced workflow with explicit validation and feedback loops, and appropriate use of bundle files for depth. The only deductions are modest internal redundancy and two reference-hygiene issues (a dangling .gitlab-ci.yml reference and an unlinked bundle file).

Suggestions

Remove or qualify the '.gitlab-ci.yml' reference in the References section — the file is not part of the bundle, so the pointer dangles for anyone reading the skill standalone.

Link references/markdown-report-example.md from the References section (e.g., 'Report format example') so the existing bundle file is discoverable from SKILL.md.

De-duplicate the risk guidance: the 'Risk Assessment Strategy' section restates the Step 4 risk table — collapsing the two (or pointing one at the other) would tighten the token budget.

DimensionReasoningScore

Conciseness

The body is command-dense and assumes competence — no padding explaining what CloudFormation or jq is — but has redundant content: the Quick Start repeats Workflow Steps 2–3 almost verbatim, and risk categories appear in both the Step 4 table and the 'Risk Assessment Strategy' section. This fits 'efficient; minor instances... that could be trimmed' better than the fully lean top anchor.

4 / 5

Actionability

Every section gives copy-paste-ready commands: complete aws CLI invocations with --query/--output flags, jq filters (including the IAM-select and cdk_nag filters), diff/comm pipelines, and a full heredoc report template. Error cases include the literal expected messages ('Stack not found', 'jq: parse error') with fixes — fully executable coverage of the common cases.

5 / 5

Workflow Clarity

The five-step workflow is clearly sequenced with explicit validation checkpoints — credential check, stack-existence check, JSON validation of both templates — and '→ If this fails:' feedback notes for recovery, plus a risk-categorization gate before reporting and an error-recovery table. This matches the top anchor (explicit validation, feedback loops); the comparison is read-only, so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

The SKILL.md is a well-organized overview with a clearly signaled References section pointing one level deep to real files (scripts/compare-cfn-templates.sh, references/compare-cfn-templates.md). However, it also cites '.gitlab-ci.yml' which is not present in the bundle, and references/markdown-report-example.md exists in the bundle but is never linked from SKILL.md — minor organization gaps that keep it below the top anchor.

4 / 5

Total

18

/

20

Passed

Description

100%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.

An exemplary description: third-person, specific, comprehensive, with an explicit 'Use when' clause and a rich set of natural trigger phrases. It clearly communicates both capability and invocation conditions with no fluff or over-claiming.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Compares deployed CloudFormation templates with locally synthesized CDK templates to detect drift, validate changes, and ensure consistency before deployment' — naming both the domain (CloudFormation/CDK) and specific capabilities. It matches the 'multiple specific concrete actions; comprehensive coverage' anchor; there is no vagueness or padding to place it lower.

5 / 5

Completeness

It explicitly answers 'what' ('Compares deployed CloudFormation templates with locally synthesized CDK templates...') and 'when' via an explicit 'Use when the user wants to...' clause enumerating seven scenarios plus concrete trigger phrases. This matches the top anchor exactly (clear what AND when with concrete trigger phrases); score 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

It includes seven natural trigger phrases users would plausibly say: 'compare templates', 'check for drift', 'cfn drift', 'stack comparison', 'infrastructure drift detection', 'safe to deploy', 'what changed in my CDK stack' — covering synonyms, jargon, and colloquial variants. This matches the comprehensive-coverage anchor; the score-4 anchor ('a few natural terms missing') doesn't apply since both formal and informal variants are present.

5 / 5

Distinctiveness Conflict Risk

The niche is clear — comparing deployed CFN templates against synthesized CDK output — with triggers ('cfn drift', 'cdk diff-style review', 'what changed in my CDK stack') that no adjacent skill (generic diffing, general AWS tooling) would claim. Minimal conflict risk, matching the 'clear niche with distinct triggers' anchor.

5 / 5

Total

20

/

20

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
pantheon-org/tekhne
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.