CtrlK
BlogDocsLog inGet started
Tessl Logo

nic-add-feature

Checklists for adding Ingress annotations, VirtualServer/VSR fields, or Helm chart values to NIC. Use when adding new configuration options, new NGINX directives, new annotations, new CRD fields, or new Helm values.

74

Quality

93%

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

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.

An excellent, highly actionable checklist skill: three clearly sequenced workflows with explicit snapshot-validation checkpoints, repo-specific gotchas, and real code examples, all with essentially no wasted tokens. The only structural improvement is moving the reference-style tables (kubebuilder markers, JSON tag conventions) into a references/ file for progressive disclosure.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence throughout: numbered steps reference exact files and functions ('internal/configs/annotations.go', 'parseAnnotations()', 'generateNginxCfg()') with zero padding and no explanation of concepts Claude already knows. Every line is repo-specific knowledge that cannot be inferred.

5 / 5

Actionability

Guidance is fully executable: exact file paths per step, runnable commands ('make update-codegen', 'make update-crds', 'make test-update-snaps'), and real code snippets (the CEL XValidation examples and kubebuilder marker table). The gotchas give concrete failure signals like 'An unchanged __snapshots__ diff after a .tmpl edit means no fixture exercises the new branch'.

5 / 5

Workflow Clarity

Each of the three workflows is a clearly numbered sequence with an explicit validation checkpoint (the snapshot step: 'run make test-update-snaps and confirm the directive appears in __snapshots__ for every edition') and feedback loops for error recovery (unchanged-diff means untested; containsDangerousChars for unsafe strings). Step 8 even covers cross-checking whether Ingress needs the same capability.

5 / 5

Progressive Disclosure

The skill has no bundle files (references/, scripts/, assets/ do not exist) and is well-organized with three clearly headed sections, so nothing is lost to buried references. It misses the 5 anchor because at ~100 lines the kubebuilder marker table and JSON tag / pointer-vs-value conventions are compact reference material that could live in a references/ file to keep SKILL.md a pure overview.

4 / 5

Total

19

/

20

Passed

Description

87%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 that explicitly states what the skill provides and when to use it, with well-chosen domain trigger terms. The only minor gap is the absence of file-level triggers (e.g., values.yaml, types.go) that would push trigger coverage to comprehensive.

Suggestions

Include concrete file-path triggers in the 'Use when' clause, e.g. 'Use when editing internal/configs/annotations.go, pkg/apis/configuration/v1/types.go, or charts/nginx-ingress/values.yaml'.

Add 'VirtualServer' and 'VSR' explicitly to the 'Use when' clause so users describing VirtualServer work match the trigger directly rather than via 'CRD fields'.

DimensionReasoningScore

Specificity

The description names concrete capabilities across three specific targets: 'Checklists for adding Ingress annotations, VirtualServer/VSR fields, or Helm chart values to NIC'. It stays below the 5 anchor because the action verb is a single generic one ('adding') rather than multiple distinct concrete actions.

4 / 5

Completeness

Both parts are explicit: the 'what' ('Checklists for adding Ingress annotations, VirtualServer/VSR fields, or Helm chart values to NIC') and the 'when' ('Use when adding new configuration options, new NGINX directives, new annotations, new CRD fields, or new Helm values') with concrete trigger phrases.

5 / 5

Trigger Term Quality

'Use when adding new configuration options, new NGINX directives, new annotations, new CRD fields, or new Helm values' covers natural phrases a developer would say, with synonyms across all three feature types. It falls short of the 5 anchor only because it omits concrete file/extension triggers a user might mention (e.g., 'values.yaml', 'types.go', 'VirtualServer spec').

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche (NGINX Ingress Controller feature work) with distinct, domain-specific triggers ('Ingress annotations', 'VirtualServer/VSR fields', 'CRD fields', 'Helm values') that are unlikely to fire for unrelated skills.

5 / 5

Total

18

/

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
nginx/kubernetes-ingress
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.