Clawhub Skill Creator

# Clawhub Skill Creator

Complete guide for creating skills compatible with clawhub registry and optimized for AI agent usage.

## Language Rule

**Skill description must be in English**, unless context requires otherwise (examples, comments, etc. may use other languages when appropriate).

- `description` in frontmatter: English only
- SKILL.md body: English preferred
- Examples, code comments: Any language as needed
- References: Any language as appropriate for domain

## Quick Start

### Create New Skill

```bash
# Run initializer
./scripts/init-skill.sh my-skill

# Or manually create structure
mkdir -p my-skill/{references,scripts,assets}
touch my-skill/SKILL.md my-skill/_meta.json my-skill/LICENSE.txt
```

## Skill Creation Workflow

### Phase 1: Understand Requirements

**Before writing any code, clarify:**

1. **What problem does this skill solve?**
   - Concrete use cases (2-3 examples)
   - Target queries that should trigger skill

2. **Who will use this skill?**
   - AI agents (primary audience for clawhub)
   - Expected context (tools available, environment)

3. **What resources are needed?**
   - References for detailed docs?
   - Assets for templates?
   - Scripts for automation?

**Output:** Clear understanding of skill scope and triggers.

### Phase 2: Plan Structure

**Choose pattern based on complexity:**

| Complexity | Structure | When to Use |
|------------|-----------|-------------|
| Simple | SKILL.md only | <100 lines, single purpose |
| Medium | + references/ | 100-300 lines, some details |
| Complex | + references/ + assets/ | >300 lines, multi-domain |

**Decide on resources:**
- Which references needed? (docs, examples, patterns)
- Which assets needed? (templates, configs)
- Which scripts needed? (validation, packaging)

**Output:** Directory structure and resource list.

### Phase 3: Initialize Structure

```bash
# Create directory
mkdir -p my-skill/{references,scripts,assets}

# Create required files
touch my-skill/SKILL.md
touch my-skil...