add-skill

Add Skill

Copy a skill from a source path to the project, verify naming consistency, and generate README.md if missing.

Usage

/add-skill <source-path>

Arguments:

• <source-path> - Path to the skill directory to add (required)

Examples:

/add-skill ~/.claude/skills/my-skill
/add-skill ~/workspace/other-project/skills/awesome-skill
/add-skill /home/leo/workspace/softaworks/projects/claude-plugins/plugins/planning/skills/spec-interview

Workflow

1. Validate Source Path

Check that the source path exists and is a directory:

if [ -d "<source-path>" ]; then
  echo "Source path exists"
else
  echo "Error: Source path does not exist or is not a directory"
  exit 1
fi

If source path is invalid, stop and report the error to the user.

2. Extract Skill Name

Get the skill name from the source path (basename of the directory):

basename <source-path>

Example: /path/to/my-skill → my-skill

Store this as the skill name for the rest of the workflow.

3. Copy Skill to Project

Copy the entire skill directory to skills/:

cp -r <source-path> skills/

Report to user: "✅ Copied skill to skills/[skill-name]"

4. Verify Folder Name is Kebab-Case

Check that the folder name follows kebab-case convention:

• Only lowercase letters, numbers, and hyphens
• No underscores, spaces, or uppercase letters

Regex pattern: ^[a-z0-9]+(-[a-z0-9]+)*$

Use Bash to check:

skill_name="[skill-name]"
if [[ $skill_name =~ ^[a-z0-9]+(-[a-z0-9]+)*$ ]]; then
  echo "Folder name is valid kebab-case"
else
  echo "Warning: Folder name is not kebab-case"
fi

If invalid, warn the user but continue (we'll check SKILL.md next).

5. Verify SKILL.md Exists and Read Frontmatter

Check for SKILL.md in the copied skill directory:

ls skills/[skill-name]/SKILL.md

If SKILL.md doesn't exist:

• Error and stop: "❌ Error: No SKILL.md found in skills/[skill-name]"
• Suggest: "Please ensure the source directory contains a valid SKILL.md file"