create-skill

Scaffold a new Claude Code plugin skill by providing a kebab-case name and optional description. The tool validates naming, checks for existing entries, recommends a type based on complexity, and creates the required SKILL.md or command files with frontmatter.

To decide between a skill or command, evaluate step count, context needs, tool variety, output complexity, and bundled resources. The scaffolding process recommends a skill for richer multi-step workflows and a lightweight command for simpler tasks, then asks for confirmation.

The correct naming format for adding a new plugin command or skill is kebab-case. The scaffolding process confirms this naming convention before creating any files to prevent collisions with existing entries in the plugin repository.

Yes, you can update a README without overwriting existing items. When scaffolding new skills or commands, the tool safely updates README tables when present, mirroring repository conventions while preserving previously registered entries.

Before adding a new skill, you need an existing plugin repository containing a SKILL.md file and command files. The tool reads these existing entries to detect collisions and mirror repository conventions when generating new capabilities.

If a skill name already exists in the plugin repository, the scaffolding process detects the collision during validation. It reads existing SKILL.md and command files to prevent accidental overwrites before creating new entries.