Skill names with colons may not conform to Claude Code / Amp skill naming rules

[acsezen]

Hi there! Thank you for this great project — it's been very helpful.

I noticed that several skills in the sdd and mcp plugins may have frontmatter that doesn't conform to the official skill naming specification.

According to the Claude Code skills documentation, the name field in SKILL.md frontmatter must be:

Lowercase letters, numbers, and hyphens only (max 64 characters).

Skills with colon-based names (sdd plugin)

The following skills use sdd: as a namespace prefix, which may cause validation errors in Claude Code and Amp:

• sdd:add-task → may need to be sdd-add-task
• sdd:brainstorm → may need to be sdd-brainstorm
• sdd:create-ideas → may need to be sdd-create-ideas
• sdd:implement → may need to be sdd-implement
• sdd:plan → may need to be sdd-plan

Skills missing the name field (mcp plugin)

These skills have a description but may be missing the name field in their frontmatter:

• setup-codemap-cli/SKILL.md
• setup-context7-mcp/SKILL.md
• setup-serena-mcp/SKILL.md

Error messages observed

⚠ Invalid skill name
Frontmatter name "sdd:add-task" is invalid. Skill name must be lowercase
alphanumeric with hyphens, no trailing hyphen (e.g., "my-skill")

⚠ Missing required fields in frontmatter
Add both "name" and "description" fields to the frontmatter

It may be worth replacing colons with hyphens (e.g., sdd-add-task) and adding the missing name fields, so the skills load cleanly without warnings.

Thanks again for the excellent work!

[LeoVS09]

Thank you @acsezen, glad that it helps you!

Hm, our team uses Claude Code mainly, and didn't see this error. Is it from Amp?
We actually have a reason why it is written like this. Claude code and some other agents by default prefix skill name with plugin name in such format <plugin>:<skill> if name frontmatter is missing, but when skill has name frontmatter, it uses exact name. The first version of the plugin was written for Claude Code even before it had an official skill format, and the name frontmatter wasn't part of it. Later, we added it to keep support of other agents, but in order not to break backward compatibility with scripts, we added the <plugin>: prefix to names.

Looks like we missed name frontmatter for mcp plugin. We will fix it for sure. But I do not want to break existing scripts and GitHub actions, by renaming other plugins. Can you elaborate on this error message? Does it totally stop you from using skills in Amp, or just show you as a warning, and fallback to some generic name?

[LeoVS09]

@acsezen I just checked the code, and plugins that you mentioned have name frontmatter. Can you please check, may it be that you use older version of marketplace?
https://github.com/NeoLabHQ/context-engineering-kit/blob/master/plugins/mcp/skills/setup-codemap-cli/SKILL.md?plain=1#L2

[acsezen]

Sorry for late answer. Yes it was from AMP.
Indeed, i think because of my custom changes plugins didnt updated.

But got something else for you.

I was trying hermes-agent this weekend and fail to succeed to install neolabhq/context-engineering-kit.

  Root Cause

  The identifier resolves to skills-sh/neolabhq/context-engineering-kit/docs:write-concisely.

  After stripping the skills-sh/ prefix, the SkillsShSource gets the canonical identifier: neolabhq/context-engineering-kit/docs:write-concisely.

  It splits this into 3 parts on / (max 2 splits):
  - parts[0] = neolabhq
  - parts[1] = context-engineering-kit
  - parts[2] = docs:write-concisely

  Then _candidate_identifiers generates these GitHub paths to try:
  1. neolabhq/context-engineering-kit/docs:write-concisely
  2. neolabhq/context-engineering-kit/skills/docs:write-concisely
  3. neolabhq/context-engineering-kit/.agents/skills/docs:write-concisely
  4. neolabhq/context-engineering-kit/.claude/skills/docs:write-concisely

  None of these exist. The actual location is:

  neolabhq/context-engineering-kit/plugins/docs/skills/write-concisely

  The problem is that docs:write-concisely is a colon-separated skill name (namespace docs, skill write-concisely), but the code treats it as a literal directory path docs:write-concisely.
  The colon is a skills.sh convention for namespacing skills within a plugin, but hermes never translates it into the actual repo directory structure (plugins/docs/skills/write-concisely).

  The _discover_identifier fallback (lines 957-1017) also fails because:
  1. It scans skills/, .agents/skills/, .claude/skills/ — none of which exist in this repo
  2. The root-directory fallback scans top-level dirs but uses skill_token = "write-concisely" (extracted from docs:write-concisely by splitting on /, not on :), so skill_token is still
  docs:write-concisely — not write-concisely

  In short: The colon-namespaced skill identifier (docs:write-concisely) is not being decomposed into the actual GitHub path (plugins/docs/skills/write-concisely).

Do you have any interest to support hermes-agent ?

Thanks

[LeoVS09]

Got it, thank you @acsezen for detailed feedback. Yes, we want to support as many agents as possible. And looks like we do not have any other way, except to remove all prefixes to make it work...
We will make a fix, but I cannot say when right now, because it is a breaking change and will require making a new major release. But we definitely will work on it.