kingkont 0.2.0 → 0.3.0

package/README.md

@@ -60,6 +60,19 @@ macOS) — переустановка приложения их не теряе
 | Cut / Copy / Paste | `Cmd+X` / `Cmd+C` / `Cmd+V` |
 | Esc | закрыть любую модалку |
 
+## Скилл для Claude Code
+
+Чтобы Claude Code в любой сессии умел запускать редактор для текущей папки:
+
+```bash
+npx kingkont install-skill            # для всех проектов: ~/.claude/skills/kingkont/
+npx kingkont install-skill --project  # только для текущего проекта: ./.claude/skills/kingkont/
+```
+
+После этого в новой сессии Claude Code достаточно сказать «открой kingkont»
+или «запусти редактор» — Claude увидит скилл, выполнит `npx -y kingkont serve`
+в текущей папке и подскажет URL для Chrome.
+
 ## Разработка
 
 ```bash

package/bin/kingkont.js

@@ -12,16 +12,37 @@ function showHelp() {
 KingKont · Chatium — видео-редактор сериала
 
 Запуск:
-  npx kingkont               запустить Electron-приложение (рекомендуется)
-  npx kingkont serve         запустить только HTTP-сервер; URL для Chrome
-  npx kingkont serve <path>  то же, путь к проекту/cwd по умолчанию
+  npx kingkont                запустить Electron-приложение (рекомендуется)
+  npx kingkont serve          запустить только HTTP-сервер; URL для Chrome
+  npx kingkont serve <path>   то же, путь к проекту/cwd по умолчанию
+  npx kingkont install-skill  установить Skill для Claude Code (~/.claude/skills/kingkont)
 
 Опции:
   --port <N>   порт сервера (по умолчанию 17893)
+  --project    install-skill: положить в .claude/skills/ текущей папки
   --help, -h   эта справка
 `);
 }
 
+function installSkill() {
+  const fs = require('node:fs');
+  const os = require('node:os');
+  const isProject = args.includes('--project');
+  const dest = isProject
+    ? path.resolve(process.cwd(), '.claude', 'skills', 'kingkont')
+    : path.join(os.homedir(), '.claude', 'skills', 'kingkont');
+  const src = path.join(root, 'skill', 'SKILL.md');
+  if (!fs.existsSync(src)) {
+    console.error('Шаблон SKILL.md не найден в пакете:', src);
+    process.exit(1);
+  }
+  fs.mkdirSync(dest, { recursive: true });
+  fs.copyFileSync(src, path.join(dest, 'SKILL.md'));
+  console.log(`✓ KingKont skill установлен: ${path.join(dest, 'SKILL.md')}`);
+  console.log('  В новой сессии Claude Code (или после /reload) скилл будет доступен:');
+  console.log('  попроси «открой kingkont» в папке проекта.');
+}
+
 if (args.includes('--help') || args.includes('-h')) {
   showHelp();
   process.exit(0);
@@ -30,6 +51,11 @@ if (args.includes('--help') || args.includes('-h')) {
 const portIdx = args.indexOf('--port');
 const port = portIdx >= 0 ? parseInt(args[portIdx + 1], 10) : 17893;
 
+if (args[0] === 'install-skill') {
+  installSkill();
+  process.exit(0);
+}
+
 if (args[0] === 'serve') {
   // Только Node-сервер. FSAH-API в Chrome требует user-gesture для
   // showDirectoryPicker — юзер сам выбирает папку через UI.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kingkont",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "KingKont · Chatium — нод-редактор сцен с AI-генерацией (картинки/видео/голос/SFX/музыка/текст)",
   "main": "main.js",
   "bin": {
@@ -14,6 +14,7 @@
     "assets/**/*",
     "bin/**/*",
     "scripts/**/*",
+    "skill/**/*",
     "README.md"
   ],
   "engines": {

package/skill/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: kingkont
+description: Use this skill when the user asks to open the KingKont editor, edit scenes, work on a film/series project, or generate content (images, video, voice, SFX, music, text) for a movie project in the current folder. The skill starts the KingKont HTTP server on the current working directory and gives the user a localhost URL to open in Chrome.
+---
+
+# KingKont · Chatium — Skill
+
+KingKont is a node-graph editor for film/series scenes with AI generation
+(images via KIE, voice/SFX/music via ElevenLabs, text via OpenRouter).
+Each "scene" is a folder on disk with `scene.json`, files live next to it.
+
+## When to use
+
+The user is working with a film/series project in the current folder and asks
+to open the KingKont editor, edit scenes, view boards visually, or generate
+media. Trigger phrases:
+
+- "открой kingkont", "запусти kingkont", "open kingkont"
+- "редактор сцен", "scene editor"
+- "видео-редактор", "film editor"
+- if the current folder contains `CLAUDE.md` mentioning "KingKont" or
+  has subfolders like `_characters/`, `_locations/` and `scene.json` files
+  — this is a KingKont project.
+
+## How to launch
+
+Run **in the current working directory** (the project root):
+
+```bash
+npx -y kingkont serve
+```
+
+It will:
+1. Auto-install `kingkont` from npm (if not cached).
+2. Spawn the HTTP server on port 17893.
+3. Print `▶ KingKont готов: http://localhost:17893/` when ready.
+
+Then tell the user to open the URL in **Chrome / Edge / Brave** (Safari and
+Firefox do not support the File System Access API needed to open project
+folders). On macOS you can open it for the user:
+
+```bash
+open -a "Google Chrome" "http://localhost:17893/"
+```
+
+The user clicks "Открыть проект" in the editor and selects the current
+folder.
+
+## Project structure (for reference)
+
+```
+<project root>/
+├── CLAUDE.md           # auto-created on first open, describes format
+├── _characters/<name>/ # one board per character
+├── _locations/<name>/  # one board per location
+├── <scene name>/       # scenes live as folders in the root
+│   ├── scene.json      # all metadata (nodes, connections, timeline, history)
+│   ├── clips/          # videos
+│   ├── images/         # frames
+│   ├── audio/          # mp3/wav
+│   └── texts/          # .md files for text nodes
+└── _deleted/           # trash; Cmd+Z restores
+```
+
+`scene.json` is plain JSON, you can read/edit it directly.
+
+## API keys
+
+If the user hasn't set them, the editor will ask via Cmd+, modal:
+- **KIE** for images/video
+- **ElevenLabs** for voice/SFX/music
+- **OpenRouter** for text and vision
+
+Stored at `~/Library/Application Support/KingKont/settings.json` (macOS)
+or `~/.config/KingKont/settings.json` (Linux).
+
+## If user wants the Electron app instead of browser
+
+```bash
+npx -y kingkont
+```
+
+This launches the desktop Electron app (downloads electron@32 on first run,
+≈70 MB).