# ai-creator-toolkit

> **Claude Code üçün hazırlanmış skill kolleksiyası — AI Creator-lar üçün.** Hər dəfə yeni layihə başlayanda, Claude artıq **sənayə səviyyəsində baş prodüser, ssenarist, rejissor, operator, bəstəkar, lirik yazıçı, səs mütəxəssisi** kimi sənə xidmət göstərir. Sən izah etmirsən — sistem **bilir**.

Pakettə **12 skill + 461 knowledge faylı + layihə şablonu** daxildir.

[![npm version](https://img.shields.io/npm/v/ai-creator-toolkit.svg)](https://www.npmjs.com/package/ai-creator-toolkit)
[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

---

## Quraşdırma — bir əmrlik (hər kompüterdə bir dəfə)

```bash
npm install -g ai-creator-toolkit
```

Bu **avtomatik**:
1. Paketi npm global-a yükləyir
2. `creator-new` əmrini `PATH`-ə əlavə edir (heç bir alias yoxdur — sistem özü tapır)
3. **`postinstall` hook**-u 12 skill-i `~/.claude/skills/`-ə symlink edir
4. Növbəti addımları göstərir

Sonra istənilən qovluqdan `creator-new` çağıra bilirsən.

> **Tələb:** Node.js 18+. Yoxdursa: [nodejs.org](https://nodejs.org) və ya `brew install node` (macOS) / `apt install nodejs` (Linux).

### Yenilənmə

```bash
npm update -g ai-creator-toolkit
```

Yeni skill və ya knowledge gəlir, symlink-lər avtomatik canlı olur — heç nə əl ilə etmək lazım deyil.

### Silmək

```bash
npm uninstall -g ai-creator-toolkit
```

`preuninstall` hook avtomatik olaraq `~/.claude/skills/`-dən bizim symlink-ləri təmizləyir. **Sənin başqa skill-lərinə toxunmur.**

---

## Hər yeni layihədə (3 əmr)

```bash
creator-new winter-reel
cd winter-reel
claude
```

Sonra Claude-da sadəcə danış:

```
30s reel hazırlayaq qışda tənhalıq haqqında, Instagram üçün
```

Claude **CLAUDE.md**-ni oxuyur (artıq layihə kontekstini bilir) və `showrunner` skill-i səni qarşılayır: bu nə layihəsidir? ssenari var, yoxsa yox? — sonra səni düzgün mütəxəssisə yönləndirir. Sən izah etmirsən, ad yadda saxlamırsan.

---

## Pakettəki 12 skill

| # | Skill | Rol | Avtomatik aktivləşmə kontekstləri | Knowledge |
|---|---|---|---|---:|
| 1 | `showrunner` | Baş prodüser / orkestrator | "yeni layihə", "haradan başlayaq", "reel/film/klip hazırlayaq" | 1 fayl |
| 2 | `screenwriter` | Ssenarist | "ssenari", "skript", "səhnə", "dialog" | 157 fayl |
| 3 | `character-designer` | Cast direktoru / obraz dizayneri | "karakter", "obraz", "turnaround", "outfit" | 4 fayl |
| 4 | `location-designer` | Məkan dizayneri | "məkan", "lokasiya", "interyer", "atmosfer" | 4 fayl |
| 5 | `director` | Rejissor + Operator | "rejissor", "kamera", "lens", "shot list", "bucaq" | 25 fayl |
| 6 | `storyboard-builder` | Storyboard | "storyboard", "grid", "3x3", "panel" | 4 fayl |
| 7 | `image-prompt-engineer` | Şəkil prompt + SFX | "Nano Banana", "Flux", "MJ", "Imagen", "SFX" | 16 fayl |
| 8 | `video-prompt-engineer` | Video prompt | "Veo", "Kling", "Runway", "Sora" | 16 fayl |
| 9 | `elevenlabs` | Səs mütəxəssisi | "səsləndirmə", "dialoq səsi", "ElevenLabs", "SFX" | 6 fayl |
| 10 | `composer` | Musiqi direktoru | "mahnı", "musiqi", "BPM", "aranjman" | 125 fayl |
| 11 | `lyricist` | Söz müəllifi / şair | "lirik", "şeir", "qəzəl", "qoşma", "rap" | 97 fayl |
| 12 | `suno-prompt-engineer` | Suno mühəndisi | "Suno", "Udio", "Suno prompt", "trend musiqi" | 6 fayl |

**Cəmi 461 knowledge faylı** — image/video/səs modelləri, kamera/lens database-i, rejissor personaları, kinematoqrafiya, musiqi nəzəriyyəsi, Azərbaycan klassik şeir formaları (qəzəl, qoşma, bayatı, rübai, və s.).

---

## Tipik iş axını

```
İstifadəçi: "30s reel hazırlayaq qışda tənhalıq haqqında"
   ↓ avtomatik showrunner
"Bu nə layihəsidir? Ssenari var, yoxsa yox?"
   ↓ ssenari yox → janr seç
screenwriter — janrın güclü ssenaristləri → ssenari + element çıxarışı (01-script/)
   ↓ (ssenari varsa: director — janrın güclü rejissorları)
   ↓ təklif: "obraz? məkan? storyboard?"
character-designer + location-designer (02-, 03-)
   ↓
director — shot list + işıq/kamera (04-storyboard/)
   ↓
storyboard-builder — 3x3 grid (04-storyboard/)
   ↓
image-prompt-engineer (05-image-prompts/)
   ↓ [sən Nano Banana / Flux-da generasiya edirsən]
video-prompt-engineer (06-video-prompts/)
   ↓ [sən Veo / Kling-də generasiya edirsən]
elevenlabs — dialoq səsləndirmə + SFX (08-audio/)

# Paralel — musiqi:
composer → lyricist → suno-prompt-engineer (07-music/)
   ↓ [sən Suno-da generasiya edirsən]
```

`showrunner` axını idarə edir, hər skill **növbəti addımı təklif edir** — heç vaxt avtomatik bütün zənciri keçmir. Sən hər mərhələdə seçirsən.

---

## Skill-ləri necə işlədirsən

**Sən heç bir ad yadda saxlamırsan.** Üç yolla:

1. **Təbii dildə danış** (ən asanı, 90% halda) — Claude `description` sahələrini oxuyur, özü uyğununu seçir
2. **`/` yaz** — autocomplete bütün skill-lərin siyahısını göstərir
3. **Birbaşa çağırış** (nadir hallarda) — `/screenwriter help me revise scene 3`

---

## Yeni layihənin qovluq strukturu

```
winter-reel/
├── CLAUDE.md              # Claude oxuyur, layihə kontekstini bilir
├── WORKFLOW.md            # showrunner yaradır — layihənin vəziyyət mənbəyi
├── README.md              # sənin üçün
├── .gitignore             # outputs/ git-ə getmir
├── 01-script/             # skript çıxışları
├── 02-characters/         # obraz reference packs (anchor + tək birləşmiş reference sheet)
├── 03-locations/          # məkan reference packs (multi-shot)
├── 04-storyboard/         # storyboard grid-lər + shot list-lər
├── 05-image-prompts/      # şəkil promptları (model üzrə)
├── 06-video-prompts/      # video promptları (model üzrə)
├── 07-music/              # composition + lyrics + Suno prompt
├── 08-audio/              # dialoq səsləndirmə (VO) + səs effektləri (SFX)
└── outputs/               # generasiya edilmiş media (git-də deyil)
```

---

## Paketin daxili strukturu

```
ai-creator-toolkit/
├── package.json
├── README.md
├── LICENSE                # MIT
├── COLLABORATION-GUIDE.md # Emin & Claude iş razılaşması (cross-project)
├── bin/
│   └── creator-new.js     # `creator-new <name>` CLI
├── lib/
│   ├── install.js         # postinstall hook (symlink skills)
│   └── uninstall.js       # preuninstall hook (clean symlinks)
├── skills/                # 12 skill folders, hər birində SKILL.md + knowledge/
│   ├── showrunner/
│   ├── screenwriter/
│   ├── ... (10 daha)
└── templates/
    └── project/           # `creator-new` bunu kopyalayır
        ├── CLAUDE.md
        ├── README.md
        ├── .gitignore
        ├── 01-script/
        ├── ... (7 daha)
        └── outputs/
```

---

## Müəllif

**[Emin Azeroglu](https://github.com/eminazeroglu)** — AI Creator, Instagram

## Lisenziya

[MIT](LICENSE)