Create Skill

Scaffold a new skill directly inside the chosen plugin of a local marketplace. The root skills/ folder is auto-generated by CI — do not create files there manually.

User's intention

$ARGUMENTS

References & shared contract

See docs/ai-tools-create-shared.md for the reference docs (skills, plugins, hooks, marketplace, …), where the form payload comes from, and the scaffold-finishing contract (scaffolded: true → finish the remaining work in place at path, don't recreate; scaffolded: false → create from scratch).

Workflow

1. Create skill directory and SKILL.md — parse the form payload (a JSON object with mode and target fields; see the shared contract above for its source and the scaffold-finishing rules).

   Target dispatch — the JSON includes a target field that determines where the skill lives:

   • target: "marketplace" — the JSON has marketplacePath and plugin. Write to <marketplacePath>/plugins/<plugin>/skills/<name>/SKILL.md.
   • target: "project" — the JSON has projectPath (the user's cwd). Write to <projectPath>/.claude/skills/<name>/SKILL.md. This is a project-local skill, not registered in any marketplace.