# skill-create

> Scaffolds a new Claude Code skill. Use when: creating a new skill, generating skill boilerplate, or starting a new slash command.

- Author: Edison
- Repository: soilmass/claudeutils
- Version: 20260127023329
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/soilmass/claudeutils
- Web: https://mule.run/skillshub/@@soilmass/claudeutils~skill-create:20260127023329

---

---
name: skill-create
description: >-
  Scaffolds a new Claude Code skill. Use when: creating a new skill,
  generating skill boilerplate, or starting a new slash command.
license: MIT
metadata:
  author: claudeutils
  version: "1.0.0"
allowed-tools: Read Write Glob WebFetch
disable-model-invocation: true
argument-hint: "[name] [description]"
---

## Task

Create a new skill that complies with the agentskills.io specification.

## Input

```
$0: Skill name (lowercase, hyphens, 1-64 chars)
$1: Skill description (optional - will prompt if missing)
```

## Instructions

1. **Validate input**
   - Name must be 1-64 characters
   - Name must be lowercase letters, numbers, and hyphens only
   - Name must not start or end with hyphen
   - Name must not contain consecutive hyphens (`--`)

2. **Fetch current spec** (if network available)
   - Fetch https://agentskills.io/specification to verify current format
   - If fetch fails, use built-in template but warn user

3. **Determine location**
   - Check if `.claude/skills/` exists → use project location
   - Otherwise ask user: project (`.claude/skills/`) or user (`~/.claude/skills/`)

4. **Create skill structure**
   ```
   {location}/{name}/
   └── SKILL.md
   ```

5. **Generate SKILL.md** with:
   - Required frontmatter: name, description
   - Recommended sections: Task, Instructions, Output
   - Placeholder content for user to fill in

## Output

### Success

```
Created: {path}/SKILL.md

Next steps:
1. Edit the skill file to add your instructions
2. Test with: /{name} [args]
3. Run /validate {path} to check compliance
```

### Error

```
ERROR: INPUT
  what: Invalid skill name
  where: $0 = "{provided_name}"
  why: {specific_reason}
  fix: Use lowercase letters, numbers, and hyphens (1-64 chars)
```

## Template

When generating SKILL.md, use this structure:

```yaml
---
name: {name}
description: >-
  {description}. Use when: {trigger}.
metadata:
  author: {user}
  version: "1.0.0"
---

## Task

{One sentence describing what this skill does}

## Instructions

1. {First step}
2. {Second step}
3. {Third step}

## Output

{Expected output format}
```