CtrlK
BlogDocsLog inGet started
Tessl Logo

nic-planning

Task planning and approach strategy for NIC. Use when starting any non-trivial task, reading issues or specs, planning before implementing, or when asked to create a plan for a change.

65

Quality

82%

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

88%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 exceptionally strong planning skill body: concrete commands, exact paths, per-condition verification steps, an explicit completion gate, and a silent-failure feedback rule make it near-copy-paste actionable. Its only real cost is deliberate redundancy — security and layer-impact guidance is restated across four sections — which trims token efficiency without materially aiding navigation.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — tables, checklists, exact paths, and commands with zero padding or explanation of known concepts. It falls short of anchor 5 because security/input-validation guidance repeats across four sections ('Identify security impact', 'Layer Impact Checklist', 'Common Planning Mistakes', 'Definition of Done') and the layer list appears twice, which could be consolidated.

4 / 5

Actionability

Fully executable instruction-only guidance: exact commands ('make update-codegen && make update-crds', 'make test-update-snaps'), exact file paths ('version1/config.go', 'pkg/apis/configuration/validation/'), and exact verification checks ('git diff -- "**/__snapshots__/**" is non-empty'). Anchor 5's 'specific examples cover the common cases' is met across the Definition of Done table, checklist, and ordering rules.

5 / 5

Workflow Clarity

Clear sequences with explicit validation checkpoints and feedback loops: the 10-step ordering for multi-layer changes, a Definition of Done gate ('Do not report a task as complete until every applicable box is ticked') with a per-condition verification column, and an explicit silent-failure recovery rule ('if make test-update-snaps changes nothing after a template edit, you have not tested the feature'). This matches anchor 5 including its feedback-loop requirement.

5 / 5

Progressive Disclosure

A single well-sectioned file with clear headers and one clearly-signaled one-level external reference ('Review the Key Invariants section in AGENTS.md'). At ~105 lines it exceeds the simple-skill threshold, and the Definition of Done / Common Mistakes tables are borderline candidates for a separate reference file — good structure with minor organization gaps, matching anchor 4.

4 / 5

Total

18

/

20

Passed

Description

66%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 serviceable description with an explicit and well-phrased 'Use when...' trigger clause, but the capability statement is thin — it never says what planning for NIC concretely involves (scope assessment, layer-impact analysis, acceptance criteria, ordered multi-layer implementation). Adding 2-3 concrete capabilities would lift specificity and distinctiveness simultaneously.

Suggestions

List 2-3 concrete planning actions in the description, e.g. 'Plans changes by assessing scope, identifying affected architectural layers (CRD, validation, templates, Helm), and defining acceptance criteria and test surface' — this raises specificity from naming the domain to enumerating capabilities.

Add distinctive trigger terms that separate this from generic planning skills, such as 'multi-layer changes', 'CRD field additions', 'template/codegen changes', or 'checking invariants before implementing' — currently 'task planning' overlaps any general planning skill.

Include a synonym for the plan artifact users might ask for, e.g. 'when asked to break down or estimate a change', to widen natural trigger coverage toward anchor 5.

DimensionReasoningScore

Specificity

The description names the domain ('Task planning and approach strategy for NIC') but offers only 1-2 concrete actions — 'planning' and 'create a plan'. It matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive' rather than score 4, which requires several listed specific actions.

3 / 5

Completeness

Both parts are explicit: the 'what' ('Task planning and approach strategy for NIC') and a clear 'Use when...' clause with multiple concrete triggers. It sits at anchor 4 rather than 5 because the 'what' is a single generic capability statement rather than a concrete action list.

4 / 5

Trigger Term Quality

Natural phrases a user would actually say are present — 'starting any non-trivial task', 'reading issues or specs', 'planning before implementing', 'create a plan for a change'. Coverage is good but falls short of anchor 5's comprehensive synonym/extension coverage (e.g., no 'design', 'break down', 'estimate', or task-size scoping terms).

4 / 5

Distinctiveness Conflict Risk

'for NIC' scopes it to the project, but 'task planning' and 'create a plan for a change' are broadly generic and would overlap with any general planning or design skill. This matches anchor 3 ('somewhat specific but could still overlap with similar skills') rather than 4, since the triggers themselves carry little unique signal.

3 / 5

Total

14

/

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.