CreateSkill Workflow

Create a new skill from scratch with proper structure and naming conventions.

Steps

1. Understand the Purpose

Ask the user:

What is this skill for?
What workflows or tasks should it include?
When should this skill be invoked?

2. Choose the Name

Use lowercase-with-hyphens (kebab-case)
Examples: docker, kubernetes, web-dev, data-analysis
Never use: Docker, WebDev, data_analysis

3. Create Directory Structure

mkdir -p ~/.config/claude/skills/[skill-name]/{workflows,tools}

4. Create SKILL.md

Create ~/.config/claude/skills/[skill-name]/SKILL.md with:

---
name: skill-name
description: Brief description. USE WHEN user mentions [trigger1], [trigger2], or needs [specific capability].
---

# Skill Name

Brief overview of what this skill provides.

## Workflow Routing

| Workflow | Trigger | File |
|----------|---------|------|
| **WorkflowName** | "trigger phrase" | `workflows/WorkflowName.md` |

## Examples

**Example 1: [Use case]**

User: “[trigger phrase]” → Invokes [WorkflowName] workflow → [What it does]

5. Create Initial Workflow

If the user wants workflows, create them in workflows/ directory using TitleCase naming for workflow files.

6. Verify Structure

Check:

✓ Directory name is lowercase-with-hyphens
✓ SKILL.md has valid YAML frontmatter
✓ name field matches directory name
✓ Description is ONE LINE with USE WHEN triggers
✓ Workflow files use TitleCase.md naming
✓ At least one example is provided

7. Present to User

Show the created structure and ask for confirmation or adjustments.

Output Format

Created skill: [skill-name]

Structure:
~/.config/claude/skills/[skill-name]/
├── SKILL.md
├── workflows/
│   └── [WorkflowName].md
└── tools/

Files created:
- SKILL.md: Main skill definition
- workflows/[WorkflowName].md: [Description]

Next steps:
- Add more workflows as needed
- Test the skill by invoking it
- Refine USE WHEN triggers based on usage