CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cdk-nag

Enforce AWS CDK security and compliance controls with cdk-nag. Use when adding rule packs, triaging findings, writing justified suppressions, integrating checks in CI/CD, or preventing insecure infrastructure patterns in CDK stacks.

77

Quality

97%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 well-structured skill body: executable commands and code with expected results, an explicit checkpointed workflow, and clean one-level-deep disclosure into a real reference bundle. The only slack is minor redundancy in the anti-patterns (Consequence lines) and a self-referential evaluation command.

Suggestions

Drop the "Consequence:" line from the anti-pattern entries — the WHY already states the risk, cutting ~9 lines with no loss of guidance.

Remove the "Evaluate this skill quality" quick command from the body (or move it to a reference file); it is skill-maintenance metadata, not guidance for someone enforcing CDK controls.

DimensionReasoningScore

Conciseness

The body is efficient — no explanation of concepts Claude already knows, terse sections, expected-result lines on each command — but the nine anti-patterns each carry a "Consequence:" line that mostly restates the WHY, and the self-referential "Evaluate this skill quality" quick command is padding for skill users, so minor trims remain. It sits above the mostly-efficient anchor (3) and just below every-token-earns-its-place (5).

4 / 5

Actionability

Fully executable, copy-paste-ready guidance throughout: "npm install --save-dev cdk-nag", "npx cdk synth" (including per-stack form), a complete TypeScript example applying AwsSolutionsChecks via Aspects, and a concrete NagSuppressions.addResourceSuppressions call — each paired with its expected result.

5 / 5

Workflow Clarity

The Deterministic Workflow is a clear six-step sequence with an explicit validation checkpoint ("If findings remain after step 3, categorize each as fix / suppress / defer... Do not advance until every finding has an owner and decision") and a re-run loop ("Re-run synth and CI checks before merge"), reinforced by the NEVER-merge-without-re-run anti-pattern.

5 / 5

Progressive Disclosure

The body is a lean overview that pushes detail to six clearly-signaled, one-level-deep reference files (all verified to exist), each annotated with what it covers; references contain only external URLs with no nested .md chains, making navigation easy.

5 / 5

Total

19

/

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.

A strong description: third-person voice, concrete verbs, an explicit "Use when..." clause with five specific trigger scenarios, and tight scoping to cdk-nag on AWS CDK. It matches the quality of the reference good examples.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Enforce AWS CDK security and compliance controls", "adding rule packs", "triaging findings", "writing justified suppressions", "integrating checks in CI/CD" — covering the skill's full workflow with no significant gaps, matching the comprehensive-coverage anchor rather than the minor-gaps anchor at 4.

5 / 5

Completeness

Both questions are answered explicitly: the first sentence states what the skill does, and "Use when adding rule packs, triaging findings, writing justified suppressions, integrating checks in CI/CD, or preventing insecure infrastructure patterns in CDK stacks" provides concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural user phrases are comprehensively covered: "cdk-nag", "rule packs", "findings", "suppressions", "CI/CD", "CDK stacks", "security and compliance" — the terms a user would actually say when needing this skill, including the tool name itself.

5 / 5

Distinctiveness Conflict Risk

A clear niche (cdk-nag on AWS CDK stacks) with distinct triggers; it would not fire for Terraform, general AWS security tooling, or application-code review, giving minimal conflict risk.

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

pantheon-org/tekhne

Path

skills/infrastructure/aws-cdk/cdk-nag/SKILL.md

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.