CtrlK
BlogDocsLog inGet started
Tessl Logo

import-unit-granularity

Use when the user is deciding how to slice Kubernetes YAML into ConfigHub Units — phrases like "one Unit or many?", "how should I split these resources?", "should Deployment and Service be one Unit?", "where do CRDs go?", "Unit per resource or per bundle?", "should my namespace and its RBAC be together?", "per-app or per-namespace?". Applies a short set of rules (CRDs separate; rendered-from-generator stays bundled; otherwise split by ownership / references / lifecycle / blast radius) and routes the user to the right import skill with a concrete Unit-slug plan. Do not load for authoring new YAML (use `config-as-data`), for executing an import the user has already scoped (use the matching `import-from-*` skill), or when the split is already forced by the tool in use (`cub helm install` and `cub gitops import` split CRDs automatically — just run them).

92

Quality

92%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

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 exceptionally well-crafted skill description. It provides rich, natural trigger phrases that match how users would actually ask about splitting Kubernetes resources into ConfigHub Units. The explicit negative routing ('Do not load for...') with named alternative skills is a best practice that minimizes conflict risk and makes skill selection highly reliable.

DimensionReasoningScore

Specificity

Lists multiple concrete actions: applies a set of rules (CRDs separate, rendered-from-generator stays bundled, split by ownership/references/lifecycle/blast radius), routes user to the right import skill, produces a concrete Unit-slug plan. Also explicitly lists what it does NOT do with specific alternatives.

3 / 3

Completeness

Clearly answers both 'what' (applies splitting rules and routes to the right import skill with a Unit-slug plan) and 'when' (explicit trigger phrases at the start). Also includes explicit 'do not use when' guidance with alternative skills, which strengthens the 'when' dimension further.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger phrases users would say: 'one Unit or many?', 'how should I split these resources?', 'should Deployment and Service be one Unit?', 'where do CRDs go?', 'Unit per resource or per bundle?', 'per-app or per-namespace?'. These are realistic user phrasings in the Kubernetes/ConfigHub domain.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with explicit negative boundaries — clearly states not to load for authoring new YAML (use config-as-data), not for executing already-scoped imports (use import-from-* skills), and not when tools auto-split CRDs. This creates very clear boundaries against related skills.

3 / 3

Total

12

/

12

Passed

Implementation

85%

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 decision-helper skill that provides concrete, actionable guidance for splitting Kubernetes resources into ConfigHub Units. The decision flow, priority-ordered rules, recommended groupings table, and worked bash example make it highly practical. Minor conciseness improvements could be made by reducing redundancy between the rules, anti-patterns, and stop conditions sections.

DimensionReasoningScore

Conciseness

The skill is fairly well-written and most content earns its place, but there's some redundancy — the CRD separation rationale is repeated across Rules, Anti-patterns, and Stop conditions. The anti-patterns section partially restates what the rules already cover. Some trimming is possible, but it's not egregiously verbose.

2 / 3

Actionability

Highly actionable: provides concrete bash commands with `cub unit import` and `--where-resource` predicates, a complete worked example splitting a namespace into four Units with dry-run validation, specific slug conventions, and a clear decision flow. Copy-paste ready.

3 / 3

Workflow Clarity

The decision flow is clearly sequenced (source → generator default vs. hand-rolled axes → slugs + predicates → hand off). Validation is explicit via `--dry-run` before committing. Stop conditions define when to halt. The preflight checklist ensures prerequisites are met before proceeding.

3 / 3

Progressive Disclosure

Well-structured with clear sections (rules, groupings table, anti-patterns, decision flow, preflight, tool boundary). References to companion skills and external docs are one-level deep and clearly signaled. Content is appropriately self-contained for a decision-helper skill while pointing to import skills for execution.

3 / 3

Total

11

/

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.