CtrlK
BlogDocsLog inGet started
Tessl Logo

space-topology

Use when the user is organizing Units, Targets, and Workers across environments or regions — phrases like "how should I structure my Spaces?", "where do dev/staging/prod go?", "multi-region layout", "one Space per environment?", "app-a-prod vs prod-app-a naming", "should these be labels or separate Spaces?", "how do I keep prod config separate from dev?", or "we're standing up a second cluster, what's the ConfigHub pattern?". Prescribes one Space per deployment boundary (environment × region × cluster), the `platform` Space for org-wide Triggers/Filters, and label/slug conventions that make cross-Space queries and cloning painless. Do not load for authoring a single Unit's YAML (use `config-as-data`), for binding a Unit to a Target (use `target-bind`), or for setting up validation Triggers (use `triggers-and-applygates`).

89

Quality

88%

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 excellent skill description that hits all the marks. It provides rich, natural trigger phrases that match how users would actually ask about environment/region organization, clearly describes what the skill prescribes, and explicitly delineates boundaries with related skills via 'Do not load for' guidance. The description is thorough without being padded, and every sentence serves a clear purpose.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions and outcomes: prescribes one Space per deployment boundary (environment × region × cluster), the `platform` Space for org-wide Triggers/Filters, and label/slug conventions for cross-Space queries and cloning. Very concrete and actionable.

3 / 3

Completeness

Clearly answers both 'what' (prescribes Space-per-deployment-boundary pattern, platform Space, label/slug conventions) and 'when' (explicit 'Use when' clause with detailed trigger phrases). Also includes explicit 'Do not load for' guidance with alternative skill references, which further strengthens completeness.

3 / 3

Trigger Term Quality

Excellent coverage of natural phrases users would say: 'how should I structure my Spaces?', 'where do dev/staging/prod go?', 'multi-region layout', 'one Space per environment?', naming conventions, 'how do I keep prod config separate from dev?', 'standing up a second cluster'. These are realistic user queries.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with clear niche around Space organization and multi-environment layout in ConfigHub. The explicit 'Do not load for' section with references to `config-as-data`, `target-bind`, and `triggers-and-applygates` actively prevents conflicts with related 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 that provides clear, actionable guidance for organizing ConfigHub Spaces. Its main strengths are the concrete CLI examples, canonical layout diagram, explicit anti-patterns, and thorough verification chain. The primary weakness is that it's somewhat long for a single file — some sections could be tightened or split out — and a few explanatory passages repeat concepts that appear elsewhere in the document.

Suggestions

Tighten the 'Why separate the home Space from deployment Spaces' section — the rationale is already partially covered in the corollary under 'The principle' and could be reduced to 2-3 sentences.

Consider extracting the detailed Worker patterns (A vs B) and promotion flow into a companion reference file to reduce the main skill's length and improve progressive disclosure.

DimensionReasoningScore

Conciseness

The skill is thorough and mostly earns its length given the complexity of the topic, but some sections are verbose — e.g., the 'Why separate the home Space from deployment Spaces' rationale paragraph and the extended explanation of why suffix naming breaks things could be tightened. The corollary explanation under 'The principle' is somewhat repetitive with the anti-patterns section.

2 / 3

Actionability

Provides concrete, executable CLI commands throughout — `cub space create`, `cub space update --label`, `cub unit create --dest-space`, cross-Space queries with `--where`. The canonical layout diagram, naming conventions, label examples, and promotion flow commands are all copy-paste ready and specific.

3 / 3

Workflow Clarity

The skill clearly sequences the workflow: preflight checks (token validation, permissions, identify what's changing), then Space creation with labels, then promotion flow with explicit commands. The verify chain provides explicit validation steps (`cub space list`, `cub space get -o json`, cross-Space query verification). Stop conditions and tool boundaries are clearly defined.

3 / 3

Progressive Disclosure

The skill references companion skills (`triggers-and-applygates`, `target-bind`, `config-as-data`, etc.) and external docs clearly, which is good. However, the content itself is a long monolithic document (~200 lines) that could benefit from splitting detailed sections (e.g., Worker patterns, promotion flow, anti-patterns) into separate reference files. No bundle files are provided to support progressive disclosure.

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.