CtrlK
BlogDocsLog inGet started
Tessl Logo

worker-bootstrap

Use when the user needs to install a ConfigHub bridge worker in a Kubernetes cluster so that Units can apply, refresh, or import against real infrastructure — phrases like "set up a worker", "install the ConfigHub worker", "connect ConfigHub to my cluster", "make ConfigHub able to deploy", "add an Argo renderer worker", "add a Flux renderer worker", "I need a worker for OCI publishing", or "the worker isn't running / is crashing". Creates the worker entity, generates the Kubernetes manifest with the right provider types, installs it (or exports it for review / storage as a ConfigHub Unit), verifies it's running, and stops before you try to deploy anything through a worker that isn't healthy. Do not load for creating Targets (use target-bind — Targets reference Workers but are a separate concern) or for day-2 application apply (use cub-apply once the worker is up).

89

Quality

88%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is an excellent skill description that covers all dimensions well. It leads with a comprehensive 'Use when' clause containing numerous natural trigger phrases, clearly describes the concrete actions performed, and explicitly disambiguates from related skills (target-bind, cub-apply). The only minor issue is the use of second person ('before you try') which technically violates the third-person voice guideline, but this is a minor stylistic point in an otherwise very strong description.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: creates the worker entity, generates the Kubernetes manifest with provider types, installs it (or exports for review/storage), verifies it's running, and stops before deploying through an unhealthy worker.

3 / 3

Completeness

Clearly answers both 'what' (creates worker entity, generates K8s manifest, installs/exports, verifies health) and 'when' (explicit 'Use when' clause at the start with detailed trigger phrases). Also includes explicit negative triggers for disambiguation (do not load for Targets or day-2 apply).

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger phrases users would say: 'set up a worker', 'install the ConfigHub worker', 'connect ConfigHub to my cluster', 'make ConfigHub able to deploy', 'add an Argo renderer worker', 'add a Flux renderer worker', 'I need a worker for OCI publishing', 'the worker isn't running / is crashing'. These are realistic user utterances.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with explicit negative boundaries ('Do not load for creating Targets — use target-bind' and 'Do not load for day-2 application apply — use cub-apply'). The domain is very specific (ConfigHub bridge worker installation in Kubernetes) and clearly delineated from adjacent skills.

3 / 3

Total

12

/

12

Passed

Implementation

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a strong, well-structured skill with excellent actionability and workflow clarity. The multi-step process is clearly sequenced with explicit validation gates, stop conditions, and two distinct installation paths. Minor weaknesses include some unnecessary explanatory prose (the 'Why this matters' section) and referenced bundle files that aren't provided, making progressive disclosure harder to fully evaluate.

Suggestions

Remove or significantly trim the 'Why this matters' section — the skill description already conveys this context, and Claude doesn't need motivation to follow instructions.

Consider extracting the managed-install path details into a referenced file to keep the main skill focused on the primary (direct install) bootstrap flow.

DimensionReasoningScore

Conciseness

The content is mostly efficient and well-structured, but includes some unnecessary explanatory text (e.g., 'Why this matters' section explaining what a Worker is, which Claude already knows from the skill description). Some inline explanations like what `--export` does could be tighter. However, it avoids egregious padding and most content earns its place.

2 / 3

Actionability

Provides fully executable, copy-paste-ready commands throughout — `cub worker create`, `cub worker install` with specific flags, `kubectl` commands for verification, and clear flag explanations. Both the direct-install and managed-install paths have concrete, runnable command sequences with specific flags and piping patterns.

3 / 3

Workflow Clarity

The workflow is clearly sequenced (preflight gates → create → install → verify → hand off) with explicit validation checkpoints at each stage. The verify chain is thorough with specific commands and expected outputs. Stop conditions are well-defined with concrete error scenarios (CrashLoopBackOff, missing secrets) and explicit feedback loops (collect logs, surface error, stop). The preflight gates prevent destructive mistakes.

3 / 3

Progressive Disclosure

References to external files like `references/cub-cli.md` and `references/yaml-patterns.md` are mentioned but no bundle files are provided, making it impossible to verify they exist. The skill itself is somewhat long (~130 lines of substantive content) and some sections like the managed-install variant details or the tool boundary section could potentially be split out. However, the structure is logical with clear section headers and the references section is well-organized.

2 / 3

Total

10

/

12

Passed

Validation

81%

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

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

9

/

11

Passed

Repository
confighub/confighub-skills
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.