🚀 AI Prompt Toolkit (ai-prompt-toolkit)

[ English | Українська ]

---

🌐 English Documentation

ai-prompt-toolkit is a collection of clean, task-focused subskills and deterministic Python helper scripts for generating and structuring AI image prompts for FLUX.1.

Instead of complex pseudo-agent orchestration state machines, each skill performs a single, clear task.

---

🌟 Included Skill

• skills/flux1: Comprehensive FLUX.1 prompt engineering skill supporting two modes:
  1. Single Prompt Generation (single_prompt): Generates a single detailed natural language prompt adhering to 77-token CLIP L rules, hex colors, typography, and positive replacements.
  2. Group Prompts Generation (group_prompts): Expands input YAML themes into structured prompt groups resolving cascading parameter inheritance and enforcing zero-padded item naming.

---

🛠️ Deterministic Python Utilities (scripts/)

• scripts/theme_parser.py: Parses input YAML files and resolves cascading theme parameters into structured JSON.
• scripts/name_formatter.py: Validates and formats group and prompt item names.

---

📂 Directory Structure

ai-prompt-toolkit/
├── SKILL.md                          # Main Toolkit index & skill router
├── README.md                         # Bilingual User Guide
├── pyproject.toml                    # UV environment configuration (pyyaml, rich)
├── skills/                           # Skill definitions
│   └── flux1/                        # FLUX.1 skill folder
│       └── SKILL.md                  # Unified FLUX.1 single & group prompt skill
├── modules/                          # Reference instruction modules
│   ├── flux_prompt_rules.md         # FLUX prompt engineering rules
│   ├── data_schemas.md              # Input/Output data schemas & cascading rules
│   ├── naming_conventions.md        # Standard naming formulas
│   └── group_processing.md          # Variation and non-monotony rules
├── scripts/                          # Deterministic Python scripts
│   ├── theme_parser.py              # YAML theme parser & cascading resolver
│   └── name_formatter.py            # Naming engine & validator
├── schemas/                          # JSON Schemas
│   ├── input_theme_schema.json
│   └── output_prompt_schema.json
└── examples/                         # Reference input & output files
    ├── input_themes_example.yaml
    └── output_prompts_example.json

---

---

🇺🇦 Інструкція українською мовою

ai-prompt-toolkit — це набір детермінованих Python-скриптів та скіла для генерації й структурування промптів генерації зображень у FLUX.1.

---

🌟 Скіл flux1

• skills/flux1: Єдиний скіл для FLUX.1, який підтримує два режими генерації:
  1. Генерація поодинокого промпта (single_prompt): Один детальний промпт із дотриманням 77 токенів CLIP L, HEX-кольорів #RRGGBB, типографіки та позитивних заміни.
  2. Генерація груп промптів (group_prompts): Розгортання YAML-тем у структуровані групи з каскадним успадкуванням та стандартом іменування (<yyyymmdd>_<owner>_<group>_<prompt>_<slug>).

---

🛠️ Автономні Python-утиліти (scripts/)

• scripts/theme_parser.py: Парсер вхідних YAML-файлів для розкриття каскадних тем.
• scripts/name_formatter.py: Перевірка та форматування іменування груп та промптів.