create-skill

Instructions

When the user invokes this skill, you are creating a new skill for their pocketskill library.

Skills are organized in three directories under plugins/my-skill/skills/:

• my-skills/ — user-created public skills (sharable)
• private-skills/ — user-created private skills (gitignored)
• manage-skills/ — built-in management skills (read-only, never create here)

Claude Code and Codex need a flat skills/<name>/SKILL.md plugin cache. Do not create files directly in that flat cache; install.sh exports it from these source directories during refresh.

First locate the pocketskill repository root:

• Use the current working directory if it contains both plugins/my-skill/skills/ and templates/SKILL.md.template.
• Otherwise search upward from the current working directory for those two paths.
• If the repository root cannot be found, ask the user for the pocketskill path. Do not create files in an unrelated project.

Workflow

1. Ask Target Directory

Ask one question if the user did not already specify:

Where should this skill live?

1. my-skills — public, can be shared via PR to the community
2. private-skills — local only, never shared (gitignored)

Never offer manage-skills as a target. It is reserved for built-in management skills.

2. Collect And Validate Inputs

Ask for the skill name and one-line description if missing.

Validate the skill name before creating anything:

• Must match ^[a-z0-9]+(-[a-z0-9]+)*$
• Must not contain /, \, ., .., spaces, shell metacharacters, or quotes
• Must not collide with an existing skill name in my-skills/, private-skills/, or manage-skills/
• If invalid, explain the rule and ask again

Trim the description. If it is empty, ask again. Keep it short because it is used for auto-trigger matching.

3. Create The Skill Safely

Use this target path:

<repo-root>/plugins/my-skill/skills/<target-dir>/<skill-name>/SKILL.md

Where <target-dir> is my-skills or private-skills.