Skip to content

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

@acsezen

Description

@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!

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions