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
88%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
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 | |
59ea831
Table of Contents
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.