new-skill

New Skill Generator

Generate a new skill for this plugin with the correct directory structure and frontmatter. This command ensures skills are discoverable by Claude Code by using the required nested directory pattern.

CRITICAL: Skills have DIFFERENT requirements than commands:

• Skills use nested directories: skills/[name]/SKILL.md
• Skills REQUIRE a name field in frontmatter
• Commands use flat files and FORBID the name field

Input Validation

Optional Arguments:

• <skill-name> - Name for the new skill (kebab-case)
• --plugin <plugin-name> - Target plugin (defaults to auto-detected or prompted)
• --pattern <name> - Base the skill on a command-pattern template instead of the default skill template (see Phase 2.2 "Pattern Adaptation"). One of conversion, generator, interactive, planning, read-only, synthesis, utility, workflow — see references/skill-patterns.md for a one-line description of each. Omit for today's default behavior (generates from references/templates/skill.md).

Plugin Target Resolution:

1. If --plugin is specified, use that plugin
2. If the current working directory is inside a plugin, use that plugin
3. If only one plugin exists in plugins/, use it automatically
4. If multiple plugins exist, scan plugins/*/ using the Glob tool and prompt the user:

   Multiple plugins detected:
     [1] personal-plugin
     [2] bpmn-plugin
   
   Which plugin should this skill be added to? (1/2):
   

Validation: If arguments are missing, the command will prompt interactively.

Skill name must be:

• kebab-case format (e.g., my-new-skill)
• Unique (not already exist in the target plugin's skills/ directory)
• Descriptive but concise

Pattern Validation: If --pattern <name> is given and <name> is not one of the 8 listed above, display:

Error: Unknown pattern '[name]'

Valid patterns: conversion, generator, interactive, planning, read-only, synthesis, utility, workflow

Omit --pattern to use the default skill template.