cdk8s-apps

CDK8s for type-safe Kubernetes manifests using Python. Use when building complex K8s applications programmatically, generating manifests from code, creating reusable infrastructure patterns, or managing multi-environment deployments.

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/cdk8s-apps/SKILL.md

Quality

Content

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

The content is highly actionable with extensive executable examples and useful validation guidance, but it suffers from redundancy and a monolithic body that overlaps with the provided reference files. Trimming the overview and pushing detailed construct/pattern content into the references would improve both conciseness and progressive disclosure.

Suggestions

Remove the duplicated 'When to Use cdk8s' section and consolidate 'Common Commands' with 'Quick Start' to eliminate redundancy and tighten the body.

Move the detailed L1/L2/L3 construct explanations and Workflow 1/2/3 into references/constructs.md and references/patterns.md, keeping SKILL.md as an overview that points to them.

Complete the L3 construct example with real code instead of the '# Compose deployment + service + ingress' placeholder comment.

Dimension	Reasoning	Score
Conciseness	The 630-line body is mostly code and structured, but includes redundant sections ('When to Use cdk8s' appears twice, commands repeated in 'Common Commands' and 'Quick Start') and an overview/benefits block explaining concepts Claude already knows.	3 / 5
Actionability	Abundant concrete, executable code covering common cases, but a few examples are incomplete: the L3 construct uses a placeholder comment ('# Compose deployment + service + ingress') and the L1 example uses an ellipsis PodTemplateSpec(...).	4 / 5
Workflow Clarity	Clear sequences for install/init/synth/deploy with validation checkpoints (dry-run, pytest, git diff in 'Test Before Deploying'), though the numbered Workflows are presented as code rather than sequenced steps with explicit checkpoints.	4 / 5
Progressive Disclosure	Real, clearly-signaled one-level references exist (getting-started.md, constructs.md, patterns.md), but substantial content duplicated in the body (construct hierarchy, workflows) that belongs in those references is inlined, making the SKILL.md oversized.	3 / 5
	Total	14 / 20 Passed

Description

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

The description is strong: it states a clear capability and provides explicit 'Use when' triggers with several concrete actions. It could be improved with a few more synonyms (e.g., .yaml, Helm) and additional actions like testing.

Dimension	Reasoning	Score
Specificity	Lists several concrete actions ('building complex K8s applications programmatically, generating manifests from code, creating reusable infrastructure patterns, or managing multi-environment deployments'), with minor gaps such as testing/importing CRDs.	4 / 5
Completeness	Explicitly answers both what ('CDK8s for type-safe Kubernetes manifests using Python') and when ('Use when building complex K8s applications programmatically, ...') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Good natural keyword coverage (CDK8s, Kubernetes manifests, K8s applications, manifests from code, multi-environment deployments) but lacks synonyms/file extensions like .yaml or Helm that users might mention.	4 / 5
Distinctiveness Conflict Risk	Clear niche (type-safe K8s manifests in Python via cdk8s) with distinct triggers; minor overlap risk with general Kubernetes or Helm skills.	4 / 5
	Total	17 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (632 lines); consider splitting into references/ and linking	Warning

	Total	15 / 16 Passed

Repository: fernandezbaptiste/Skrillz
Path: skills/cdk8s-apps/SKILL.md
Commit: 93ed392

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

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.