Bug: Sub-skill `name` frontmatter doesn't match directory name (6 validation errors)

[dxvidparham]

Summary

Running agnix (the skill/agent lint tool) against the installed skill reveals 6 validation errors where the name field in each sub-skill's YAML frontmatter includes a ckm prefix, but the containing directory does not. Tools that resolve skills by directory name will fail to locate these sub-skills correctly.

Errors (verbatim agnix output)

.claude/skills/banner-design/SKILL.md:2:1  error: Skill name 'ckmbanner-design' must match parent directory 'banner-design'
.claude/skills/brand/SKILL.md:2:1          error: Skill name 'ckmbrand' must match parent directory 'brand'
.claude/skills/design/SKILL.md:2:1         error: Skill name 'ckmdesign' must match parent directory 'design'
.claude/skills/design-system/SKILL.md:2:1  error: Skill name 'ckmdesign-system' must match parent directory 'design-system'
.claude/skills/slides/SKILL.md:2:1         error: Skill name 'ckmslides' must match parent directory 'slides'
.claude/skills/ui-styling/SKILL.md:2:1     error: Skill name 'ckmui-styling' must match parent directory 'ui-styling'

Affected files

File	Current name	Expected name
.claude/skills/banner-design/SKILL.md	ckmbanner-design	banner-design
.claude/skills/brand/SKILL.md	ckmbrand	brand
.claude/skills/design/SKILL.md	ckmdesign	design
.claude/skills/design-system/SKILL.md	ckmdesign-system	design-system
.claude/skills/slides/SKILL.md	ckmslides	slides
.claude/skills/ui-styling/SKILL.md	ckmui-styling	ui-styling

Suggested Fix

In each SKILL.md frontmatter, strip the ckm prefix from name to match the directory:

---
name: banner-design   # was: ckmbanner-design

Alternatively, rename each directory to include the ckm prefix (e.g. ckmbanner-design/) and update all cross-references accordingly — but that's a larger change.

Reproduction

# Install agnix
npm install -g agnix

# Clone and validate
git clone https://github.com/nextlevelbuilder/ui-ux-pro-max-skill
agnix ./ui-ux-pro-max-skill/
# → Found 6 errors

Validated with agnix v0.17.0 on April 18, 2026.

[mrgoonie]

Summary: I validated the report against the current main branch. The concrete strings in the report are slightly stale, but the underlying compatibility issue is real: six sub-skill directories have frontmatter names with the `ckm:` prefix while the directories are unprefixed.

Decision: confirmed / accepted

Evidence:

• Current `.claude/skills/banner-design/SKILL.md`, `brand/SKILL.md`, `design/SKILL.md`, `design-system/SKILL.md`, `slides/SKILL.md`, and `ui-styling/SKILL.md` use names like `ckm:banner-design` while their parent directories are `banner-design`, `brand`, etc.
• The repo also has `.claude/skills/ui-ux-pro-max/SKILL.md` with `name: ui-ux-pro-max`, so the orchestrator skill already follows directory-name alignment.
• No merged fix or duplicate issue was found for this exact frontmatter/directory-name mismatch.

Next step: fix should be narrow: either align the six sub-skill `name` fields to their directory names, or document/verify that the target loader supports colon-prefixed names independently from directory resolution. If the goal is broad installer compatibility, matching directory names is the safer path.

[mrgoonie]

Maintainer follow-up after PR #383: that PR fixed the Agent Skills character-validation problem by replacing ckm: with ckm- in the six sub-skill names, so the names now satisfy lowercase/hyphen-only validators.

This issue should stay open for the stricter directory-name alignment question. The current merged names are still prefixed (ckm-banner-design, ckm-brand, etc.) while the directories remain unprefixed (banner-design, brand, etc.). If the target loader requires name to equal the parent directory exactly, the remaining fix should either strip the ckm- prefix from those six name fields or rename the directories and update references consistently.

[mrgoonie]

Maintainer recheck on current main (bdf1179): PR #383 removed the invalid colon characters, but this issue is still not fully resolved for validators that require the frontmatter name to equal the parent skill directory.

Current evidence:

• .claude/skills/banner-design/SKILL.md has name: ckm-banner-design, parent directory is banner-design.
• .claude/skills/brand/SKILL.md has name: ckm-brand, parent directory is brand.
• .claude/skills/design/SKILL.md has name: ckm-design, parent directory is design.
• .claude/skills/design-system/SKILL.md has name: ckm-design-system, parent directory is design-system.
• .claude/skills/slides/SKILL.md has name: ckm-slides, parent directory is slides.
• .claude/skills/ui-styling/SKILL.md has name: ckm-ui-styling, parent directory is ui-styling.
• .claude/skills/ui-ux-pro-max/SKILL.md already matches its directory (ui-ux-pro-max).

Recommendation: keep this open until a narrow follow-up either strips the ckm- prefix from those six name fields or intentionally renames the directories and updates references. The smaller/safer fix is to make name match the existing directories.