CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

preflight

Production-readiness preflight check for a directory, repo, or single file. Auto-detects file types (Kubernetes manifests, Terraform, GitHub Actions workflows, Helm values/charts, Flux Kustomizations/HelmReleases, Dockerfiles, shell scripts) and applies type-specific checks across the whole scope. Returns a per-file summary table and aggregated verdict. Use before deploying, merging, or applying a folder of config. For PR diffs spanning multiple files use /platform-skills:pr-review instead. For deep Helm chart work use /platform-skills:helmchart instead.

Quality

92%

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

The canonical home for this skill is preflight in nitinjain999/platform-skills

SKILL.md
Quality
Evals
Security

Quality

Content

85%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 highly actionable, well-sequenced review workflow with concrete commands, exact output contracts, and honest verification semantics. Its main weaknesses are repeated rule statements that cost tokens and a fully monolithic structure that inlines 13 type-specific checklists instead of splitting them into per-type reference files.

Suggestions

Move the Step 6 type-specific checklists into per-type reference files (e.g. references/kubernetes.md, references/terraform.md) and instruct the skill to read only the files matching detected types — this converts the ~630-line monolith into a lean core with one-level-deep progressive disclosure.

State the '--json takes precedence over --bot' rule and the Tool-verified evidence requirement once each (in Step 0 and the Confidence table) and drop the repetitions in Step 8/Common mistakes, or compress Common mistakes to one-line pointers to the rule's home location.

Trim justification prose in long checklist bullets (e.g. the serviceAccountName and KEDA/HPA conflict explanations) to a short rationale plus a pointer, keeping the trigger conditions and severities inline.

DimensionReasoningScore

Conciseness

Dense, table-driven checklists with essentially no explanation of concepts Claude already knows, but there is real redundancy: the "--json silently wins over --bot" rule is stated in Step 0, Step 8, and Common mistakes; the Tool-verified honesty rule appears in the matrix, as a Hard rule, and again in Common mistakes. Anchor 4 (efficient, minor trimming) rather than 5 — those repeats and several long justification bullets could be consolidated.

4 / 5

Actionability

Fully executable guidance throughout: exact tool invocations with flags ("kubectl apply --dry-run=server -f <file>", "zizmor --strict-collection --offline <file>"), a copy-paste gh api comment-update snippet, discovery find commands, and the git diff base-resolution algorithm. Not 4: commands cover the common cases including fallback paths, and the output templates are concrete field-by-field specs.

5 / 5

Workflow Clarity

Steps 0–9 are clearly sequenced with explicit validation checkpoints: every finding carries a "Validation step" field, Confidence labels enforce evidence-backed tool claims, and failure paths are handled (tool-missing fallback note, --changed-only base-resolution fallback, KEDA single-file-mode limitation noted inline). Validation is present for this batch-review workflow, so the destructive/batch cap does not apply. Not 4: error-recovery feedback loops and per-type checklists are explicit, not implicit.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/); all 13 per-type checklists and three full output-format specifications are inlined in one ~630-line file. The per-type checklists could live in one-level-deep reference files loaded only for detected types, which would cut context cost per run substantially. Anchor 3 (content that should be separate is inline) rather than 2 because internal sectioning (Steps 0–9, headers, tables) is strong; not 4 because the split opportunity is substantial, not a minor gap.

3 / 5

Total

17

/

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: concrete capabilities, explicit use-when triggers with natural terminology, and explicit boundaries that route overlapping requests to sibling skills. No vague fluff or over-claims.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "Auto-detects file types", "applies type-specific checks", "Returns a per-file summary table and aggregated verdict" — plus a comprehensive enumeration of supported types (Kubernetes manifests, Terraform, GitHub Actions, Helm, Flux, Dockerfiles, shell scripts). Matches anchor 5 rather than 4 because coverage of the platform-config domain leaves no notable gaps.

5 / 5

Completeness

Explicitly answers both: what ("Auto-detects file types … applies type-specific checks … Returns a per-file summary table and aggregated verdict") and when ("Use before deploying, merging, or applying a folder of config") with concrete trigger phrases. Not 4: the when-clause is explicit and specific, not merely present.

5 / 5

Trigger Term Quality

Natural user phrasing is comprehensive: "preflight check", "before deploying, merging, or applying", plus every relevant technology name (Kubernetes, Terraform, Helm, Flux, Dockerfiles, shell scripts) and synonyms ("directory, repo, or single file"). Not 4: no meaningful natural terms are missing for this domain.

5 / 5

Distinctiveness Conflict Risk

Clear niche (production-readiness preflight of config scopes) with active de-confliction boundaries — "For PR diffs spanning multiple files use /platform-skills:pr-review instead. For deep Helm chart work use /platform-skills:helmchart instead" — minimizing the chance of triggering for the wrong skill.

5 / 5

Total

20

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (637 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

nitinjain999/platform-skills

Path

plugins/platform-skills/skills/preflight/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.