CtrlK
BlogDocsLog inGet started
Tessl Logo

k8s

Operate the joelclaw Kubernetes cluster — Talos Linux on Colima (Mac Mini). Deploy services, check health, debug pods, recover from restarts, add ports, manage Helm releases, inspect logs, fix networking. Triggers on: 'kubectl', 'pods', 'deploy to k8s', 'cluster health', 'restart pod', 'helm install', 'talosctl', 'colima', 'nodeport', 'flannel', 'port mapping', 'k8s down', 'cluster not working', 'add a port', 'PVC', 'storage', any k8s/Talos/Colima infrastructure task. Also triggers on service-specific deploy: 'deploy redis', 'redeploy inngest', 'livekit helm', 'pds not responding'.

70

Quality

87%

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

75%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 body is a high-signal operations runbook: concrete, executable, and rich with validated recovery procedures and a well-signaled external reference. Its main weaknesses are repetition of the endpoint/force-cycle material and inline time-sensitive incident notes that bloat the always-loaded context.

Suggestions

Deduplicate the kubeconfig/Talos endpoint contract and the Colima force-cycle recovery sequence — state each once and cross-reference, to trim the always-loaded body.

Move dated incident notes (2026-03-17, 2026-04-15/16/19, 2026-05-30) into a clearly labeled 'Incident history / deprecated patterns' section or into references/operations.md so time-sensitive detail does not penalize the live overview.

Consider offloading the 20-item Danger Zones list (or its long-form entries) to references/operations.md, keeping a short index of the top traps inline.

DimensionReasoningScore

Conciseness

The 535-line body assumes Claude's competence (no basic k8s concept explanations) and is dense with hard-won operational lore, but it carries noticeable repetition — the kubeconfig/Talos endpoint contract and the full Colima force-cycle sequence each appear in two places — and scatters time-sensitive incident dates (2026-03-17, 2026-04-15, 2026-04-16, 2026-04-19, 2026-05-30) inline in active sections rather than a deprecated/old-patterns section, matching the score-3 anchor 'mostly efficient but could be tightened' rather than the score-4 'minor instances'.

3 / 5

Actionability

Fully executable throughout — concrete kubectl/helm/talosctl commands, a copy-paste-ready Redis AOF recovery Pod manifest, curl-based health checks with expected responses, and explicit deploy sequences — covering the common operational cases, matching the score-5 anchor.

5 / 5

Workflow Clarity

Recovery workflows are sequenced with explicit validation checkpoints and feedback loops (the Durable recovery rule's repeated-pass stability window, 'a Colima force-cycle now requires confirmed evidence', NFS/route verification steps), so the destructive-operation cap at 3 does not apply; however validation is not uniform across all sections — the Deploy Commands block is a flat command list without checkpoints — placing this at the score-4 anchor rather than score-5.

4 / 5

Progressive Disclosure

Structure is good with clearly signaled one-level-deep references to references/operations.md (linked in four places with explicit 'read … for' framing) and well-defined sections (Architecture, Quick Health Check, Services, Danger Zones, Key Files, Troubleshooting); minor organization gaps remain since large inline blocks like the 20-item Danger Zones and incident-specific rules could arguably be offloaded to the reference, keeping this at score-4 rather than score-5.

4 / 5

Total

16

/

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.

The description is third-person, concrete, and explicitly pairs capability statements with a rich 'Triggers on' clause, cleanly satisfying both the what and when requirements. It is somewhat long due to the trigger-term list, but every term earns its place and nothing is vague fluff.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Deploy services, check health, debug pods, recover from restarts, add ports, manage Helm releases, inspect logs, fix networking' — giving comprehensive coverage of the cluster-operations domain, matching the score-5 anchor rather than the score-4 anchor which expects only 'several specific actions' with gaps.

5 / 5

Completeness

Explicitly answers both 'what' (operate the joelclaw cluster: deploy, health, debug, recover, ports, helm, logs, networking) and 'when' via an explicit 'Triggers on:' clause with concrete trigger phrases, exactly matching the score-5 anchor; the missing-'when' cap at 3 does not apply.

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage including synonyms and tool names a user would actually say — 'kubectl', 'pods', 'deploy to k8s', 'cluster health', 'restart pod', 'helm install', 'talosctl', 'colima', 'k8s down', 'cluster not working', 'add a port', 'PVC', plus service-specific triggers — matching the score-5 anchor and clearly above the score-4 anchor's 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

Targets a sharply defined niche — the joelclaw Kubernetes cluster on Talos Linux via Colima on a Mac Mini — with cluster- and tool-specific triggers, yielding minimal conflict risk with other skills, matching the score-5 'clear niche with distinct triggers' anchor.

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.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (536 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
joelhooks/joelclaw
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.