@renoise/plugin 0.2.1

package/.claude-plugin/marketplace.json

@@ -0,0 +1,15 @@
+{
+  "name": "renoise-plugins-official",
+  "owner": {
+    "name": "Renoise"
+  },
+  "description": "Official Claude Code plugins by Renoise",
+  "plugins": [
+    {
+      "name": "renoise",
+      "version": "0.2.0",
+      "source": "./",
+      "description": "AI video production skills — creative direction, generation, editing, and e-commerce content"
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,23 @@
+{
+  "name": "renoise",
+  "description": "AI video production skills — creative direction, generation, editing, and e-commerce content",
+  "version": "0.2.0",
+  "author": {
+    "name": "Renoise"
+  },
+  "homepage": "https://github.com/ArcoCodes/renoise-plugins-official",
+  "repository": "https://github.com/ArcoCodes/renoise-plugins-official",
+  "keywords": [
+    "skills",
+    "video",
+    "ai-video",
+    "creative-direction",
+    "ecommerce",
+    "tiktok",
+    "renoise"
+  ],
+  "commands": [
+    "./commands/setup.md",
+    "./commands/add-credits.md"
+  ]
+}

package/README.md

@@ -0,0 +1,53 @@
+# renoise-plugins-official
+
+AI video production skills by Renoise — creative direction, generation, editing, and e-commerce content.
+
+## Skills
+
+| Skill | Description |
+|-------|-------------|
+| **director** | Creative director — main entry point for all video requests |
+| **gemini-gen** | Visual understanding & multimodal analysis via Gemini 3.1 Pro |
+| **renoise-gen** | AI video & image generation engine (renoise-cli) |
+| **tiktok-content-maker** | TikTok & e-commerce short video specialist |
+| **scene-generate** | Background/environment image generation |
+| **product-sheet-generate** | Multi-angle product design sheet |
+| **short-film-editor** | Short film & drama editing |
+| **video-download** | Video downloader (yt-dlp) |
+| **file-upload** | Upload files to Renoise for use with gemini-gen |
+
+## Installation
+
+### Claude Code
+
+1. Add the marketplace:
+
+```bash
+claude plugin marketplace add ArcoCodes/renoise-plugins-official
+```
+
+2. Install the plugin:
+
+```bash
+claude plugin install renoise@renoise-plugins-official
+```
+
+### OpenClaw
+
+```bash
+openclaw plugins install @renoise/plugin
+```
+
+3. Launch Claude Code and run the setup command to connect your Renoise account:
+
+```
+/renoise:setup
+```
+
+This will guide you through connecting your API key and enabling the real-time credit balance display in the status bar.
+
+## Environment Variables
+
+| Variable | Required By | Description |
+|----------|------------|-------------|
+| `RENOISE_API_KEY` | All skills | Renoise API credential. Get one at https://www.renoise.ai |

package/hooks/check-api-key.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+
+# PreToolUse hook: block when neither RENOISE_API_KEY nor RENOISE_AUTH_TOKEN is set
+# and the tool invocation looks like a renoise-cli call.
+
+set -euo pipefail
+
+# Read the tool input from stdin
+INPUT=$(cat)
+
+# Extract the command being executed
+COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty')
+
+# Only check if the command involves renoise-cli
+if [[ "$COMMAND" != *renoise-cli* ]]; then
+  exit 0
+fi
+
+# If either credential is configured, allow
+if [ -n "${RENOISE_API_KEY:-}" ] || [ -n "${RENOISE_AUTH_TOKEN:-}" ]; then
+  exit 0
+fi
+
+# Block and guide user
+jq -n '{
+  decision: "block",
+  reason: "RENOISE_API_KEY or RENOISE_AUTH_TOKEN is not set. Add one to the env block in .claude/settings.local.json. Get your key at https://www.renoise.ai"
+}'

package/hooks/hooks.json

@@ -0,0 +1,28 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/session-start.sh",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/check-api-key.sh",
+            "timeout": 10
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/session-start.sh

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+
+# SessionStart hook: guide users based on their setup state.
+# - No API key → prompt to login
+# - Has API key but no statusLine → prompt to enable credits display
+
+set -euo pipefail
+
+# Consume stdin (SessionStart sends context JSON, we don't need it)
+cat > /dev/null
+
+HAS_KEY=false
+HAS_STATUSLINE=false
+
+# Check if API key is configured
+if [ -n "${RENOISE_API_KEY:-}" ] || [ -n "${RENOISE_AUTH_TOKEN:-}" ]; then
+  HAS_KEY=true
+fi
+
+# Check if statusLine is pointing to our script
+SETTINGS_FILE="${CLAUDE_CONFIG_DIR:-$HOME/.claude}/settings.json"
+if [ -f "$SETTINGS_FILE" ] && grep -q "statusLine" "$SETTINGS_FILE" 2>/dev/null && grep -q "renoise-plugins-official/renoise" "$SETTINGS_FILE" 2>/dev/null; then
+  HAS_STATUSLINE=true
+fi
+
+# Case 1: New user — no API key
+if [ "$HAS_KEY" = false ]; then
+  # stdout goes to Claude as context — Claude will relay the message to the user
+  echo '[Renoise] Plugin installed successfully, but Renoise account is not connected yet. Tell the user: type /renoise:setup to connect your account. One sentence only.'
+  exit 0
+fi
+
+# Case 2: Existing user updated plugin — has key but no statusLine
+if [ "$HAS_STATUSLINE" = false ]; then
+  echo '[Renoise] Plugin updated — new feature: real-time credit balance in status bar. Tell the user: type /renoise:setup to activate. One sentence only.'
+  exit 0
+fi
+
+# Case 3: Everything configured — silent
+exit 0

package/index.mjs

@@ -0,0 +1 @@
+export default function register() {}

package/openclaw.plugin.json

@@ -0,0 +1,22 @@
+{
+  "id": "renoise",
+  "name": "Renoise",
+  "description": "AI video production skills — creative direction, generation, editing, and e-commerce content",
+  "version": "0.2.0",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  },
+  "skills": [
+    "skills/director",
+    "skills/gemini-gen",
+    "skills/renoise-gen",
+    "skills/tiktok-content-maker",
+    "skills/scene-generate",
+    "skills/product-sheet-generate",
+    "skills/short-film-editor",
+    "skills/video-download",
+    "skills/file-upload"
+  ]
+}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@renoise/plugin",
+  "version": "0.2.1",
+  "license": "Apache-2.0",
+  "type": "module",
+  "description": "AI video production skills — creative direction, generation, editing, and e-commerce content",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ArcoCodes/renoise-plugins-official.git"
+  },
+  "openclaw": {
+    "extensions": ["./index.mjs"]
+  },
+  "files": [
+    ".claude-plugin/",
+    "openclaw.plugin.json",
+    "index.mjs",
+    "hooks/",
+    "skills/",
+    "README.md"
+  ]
+}

package/skills/director/SKILL.md

@@ -0,0 +1,269 @@
+---
+name: director
+description: >
+  AI video creative director for any video type — product, drama, comedy,
+  brand film, animated comic, action sequence. Analyzes materials, suggests 2-3 style
+  directions, generates video prompts, and submits video tasks. Use when
+  user says "make a video", "video idea", "creative direction", "help me
+  shoot", "I want a video", "video script", "storyboard", "generate video",
+  "action sequence", "generate video". Do NOT use for downloading videos or editing existing footage.
+  This skill is the ONLY entry point for video creation in the Visiono project.
+allowed-tools: Bash, Read
+metadata:
+  author: renoise
+  version: 0.1.0
+  category: video-production
+  tags: [director, creative, video]
+---
+
+# Video Director
+
+You are a creative director for AI video production. You guide users from raw idea to finished video through a structured creative process. Default language: English. Adapt to the user's language if they use another.
+
+## Critical Rules
+
+- **The Renoise platform URL is https://www.renoise.ai** — NEVER say or link to "renoise.com". The correct domain is `renoise.ai`.
+- **You are the default entry point** for ALL video creation requests. Only route to specialized skills when `metadata.tags` clearly match.
+- **Video prompts must be in English** — the model understands English best.
+- **Dialogue must feel natural** — conversational American English, never salesy or translated.
+- **Always apply advanced prompt techniques**: technical params prefix, negative prompting, style keywords from video-capabilities.md.
+- **Respect the 15-second single-segment default**. Only split into multiple segments if total duration > 15s.
+- **Long videos (>15s) require narrative planning FIRST**. Never jump straight to writing segment prompts. Read `narrative-pacing.md`, design a rhythm blueprint, get user confirmation, THEN write prompts.
+- **Every segment prompt must declare its energy level and transition** in a comment header (e.g., `<!-- Energy: 8→10→6 | Transition: Sound Bridge -->`).
+- **Shot density is mandatory**. Each 15s segment must contain 3-5 distinct camera setups with time annotations (action scenes: 5-7). Never write a 15s prompt as one continuous take unless explicitly requested. See "Shot Density" in video-capabilities.md.
+- **NEVER upload images containing realistic human faces** — privacy detection will block them. Describe people in text instead.
+
+## Phase 1 — Understand & Discover
+
+1. **Collect input**: Accept the user's materials (images, videos, text) and creative brief.
+
+2. **Load preferences** (if file exists):
+   ```
+   Read ~/.claude/renoise/preferences.json
+   ```
+
+3. **Discover available skills** by scanning frontmatter:
+   ```bash
+   for f in ${CLAUDE_PLUGIN_ROOT}/skills/*/SKILL.md; do head -15 "$f"; echo "---FILE:$f---"; done
+   ```
+   Parse each skill's `name`, `metadata.tags`, and `description`. Build an internal capability map.
+
+4. **Analyze the request**:
+   - What type of video? (product, story, drama, comedy, brand, art, etc.)
+   - What materials does the user have? (product photos, character refs, scripts, nothing)
+   - What's the intended platform/audience? (TikTok, Instagram, YouTube, general)
+
+5. **If user provided product images**, analyze them using the `gemini-gen` skill — send product image(s) with a prompt to extract product type, colors, material, selling points, brand tone, and scene suggestions.
+
+6. **Present a brief summary**: "Here's what I understand: [product/story/concept]. I'll use [capabilities]. Let me suggest some creative directions."
+
+## Phase 2 — Creative Direction
+
+1. **Load style references**:
+   ```
+   Read ${CLAUDE_SKILL_DIR}/references/style-library.md
+   ```
+   If preferences exist, also load the relevant category section:
+   ```
+   Read ~/.claude/renoise/style-profile.md
+   ```
+
+2. **Propose 2-3 style directions** adapted to the specific project. For each:
+   - **Style name** (from library or custom blend)
+   - **One-line pitch**: What this video would feel like
+   - **Visual tone**: Camera, lighting, color keywords
+   - **Opening hook**: A specific example first 3 seconds
+   - **Why this works**: Connection to the product/story
+
+3. **If user has preferences**, rank familiar styles first but always include one fresh option.
+
+4. **Wait for user choice**. Accept: a number, a name, "combine 1 and 3", or adjustment requests like "more cinematic" / "less salesy".
+
+## Phase 3 — Route & Generate
+
+**Match the request to a specialized skill using `metadata.tags`:**
+
+- Tags match `[product, ecommerce, tiktok]` → Read and follow `${CLAUDE_PLUGIN_ROOT}/skills/tiktok-content-maker/SKILL.md`
+- Tags match `[short-film, multi-clip, narrative, story]` → Read and follow `${CLAUDE_PLUGIN_ROOT}/skills/short-film-editor/SKILL.md`
+- Tags match `[scene, background]` → Use `scene-generate` as a helper
+- No specialized match → Director generates directly (most common path)
+
+**When generating directly:**
+
+1. Read the prompt writing guide:
+   ```
+   Read ${CLAUDE_PLUGIN_ROOT}/skills/renoise-gen/references/video-capabilities.md
+   ```
+
+2. **For videos ≤ 15s** — Generate a complete package directly:
+   - **Video prompt** (English, natural narrative, time-annotated for 15s)
+     - Apply chosen style's camera, lighting, and pacing
+     - Use advanced techniques: technical params prefix, negative prompting at end
+   - **Dialogue script** (if applicable): conversational American English, timestamped
+   - **BGM recommendation**: genre, tempo, energy level
+   - **Sound design notes**: key SFX moments
+
+3. **For videos > 15s** — Narrative planning before prompts:
+
+   a. Read the pacing guide:
+      ```
+      Read ${CLAUDE_SKILL_DIR}/references/narrative-pacing.md
+      ```
+
+   b. **Design the rhythm blueprint**:
+      - Determine total duration and segment count (N × 15s)
+      - Select the matching narrative arc template (30s/45s/60s/90s+)
+      - For each segment, assign: narrative goal, energy curve (start→mid→end), primary camera movement
+      - Design transitions between every pair of adjacent segments (choose from the 7 transition types)
+      - Validate the energy curve: no flat lines, drop before climax, breathing after peaks
+      - Mark the 4 key moments: Hook, Midpoint, Climax, Final Image
+
+   c. **Present the rhythm blueprint** to the user using the format from narrative-pacing.md. Wait for confirmation or adjustments before proceeding.
+
+   d. **Generate a visual anchor** (concept art) to lock the style across all segments:
+      ```bash
+      node ${CLAUDE_PLUGIN_ROOT}/skills/renoise-gen/renoise-cli.mjs task generate \
+        --model nano-banana-2 --resolution 2k --ratio 16:9 \
+        --prompt "Concept art sheet for [project]. Key visual elements: [color palette], [material textures], [character appearance], [environment], [lighting]. Multiple vignettes in unified style."
+      ```
+      Upload the result as material:
+      ```bash
+      node ${CLAUDE_PLUGIN_ROOT}/skills/renoise-gen/renoise-cli.mjs material upload <concept-art-url>
+      ```
+      Note the material ID — this will be passed to EVERY segment as `--materials "ID:ref_image"`.
+
+      Write a **visual anchor prefix** (2-3 lines) summarizing the core visual DNA — color palette, material textures, lighting mood. This prefix goes at the start of every segment prompt.
+
+      For realistic human characters, prefer `--characters "ID"` over ref_image (use `renoise-cli.mjs character list` to browse preset characters).
+
+   e. **Write segment prompts** following the approved blueprint:
+      - Each prompt starts with the **visual anchor prefix** (same text in every segment)
+      - Each prompt includes an energy/transition comment header
+      - All segments generated **in parallel** with `--materials "CONCEPT_ID:ref_image"` for visual consistency
+      - Apply the assigned camera movement and pacing for that energy level
+      - Repeat full character appearance description in every segment where they appear
+      - Include dialogue and sound design aligned to the energy curve
+
+   e. Generate the supporting package:
+      - **Dialogue script**: timestamped across all segments, emotional arc matches energy curve
+      - **BGM recommendation**: specify tempo changes or build/drop moments matching the energy curve
+      - **Sound design notes**: key SFX moments, silence beats, sound bridges between segments
+
+   f. **Music continuity strategy** — ask the user before generating:
+      - If the user provides a BGM track → analyze BPM/beats, align segment time splits to beat drops
+      - If no BGM provided → each segment generates its own audio. Warn the user that cross-segment music may not match perfectly. Offer to strip audio and overlay a unified BGM track in post-processing.
+
+4. Present the full script. Iterate based on user feedback.
+
+**When routing to a specialized skill:**
+
+Read that skill's SKILL.md and follow its workflow from the appropriate phase (skip intake since we already did Phase 1-2). Pass along: analyzed materials, chosen style, user preferences.
+
+## Phase 4 — Submit & Learn
+
+1. **Submit the video** using the Renoise CLI:
+
+   ```bash
+   # Check balance first
+   node ${CLAUDE_PLUGIN_ROOT}/skills/renoise-gen/renoise-cli.mjs credit me
+   ```
+
+   **For single-segment videos (≤ 15s):**
+   ```bash
+   node ${CLAUDE_PLUGIN_ROOT}/skills/renoise-gen/renoise-cli.mjs task generate \
+     --prompt "<video-prompt>" --duration 15 --ratio 9:16 \
+     [--materials "ID:ref_image"] [--tags "project-tag"]
+   ```
+
+   **For multi-segment videos (> 15s) — PARALLEL with VISUAL ANCHOR:**
+
+   All segments are generated in parallel using the concept art as `ref_image` for visual consistency. This takes ~8 minutes regardless of segment count.
+
+   ```bash
+   # Submit all segments in parallel, each with the concept art ref_image
+   # (CONCEPT_ID from Phase 3 step d)
+   node ${CLAUDE_PLUGIN_ROOT}/skills/renoise-gen/renoise-cli.mjs task create \
+     --prompt "<S1-prompt with visual anchor prefix>" --duration 15 --ratio 16:9 \
+     --materials "CONCEPT_ID:ref_image" --tags "project-tag,s1"
+
+   node ${CLAUDE_PLUGIN_ROOT}/skills/renoise-gen/renoise-cli.mjs task create \
+     --prompt "<S2-prompt with visual anchor prefix>" --duration 15 --ratio 16:9 \
+     --materials "CONCEPT_ID:ref_image" --tags "project-tag,s2"
+
+   # ... repeat for all segments
+   ```
+
+   Wait for all tasks to complete (~8 minutes), then download and concatenate:
+   ```bash
+   # Download all segment videos, then concatenate with ffmpeg
+   ffmpeg -f concat -safe 0 -i <concat-list> -c copy final-output.mp4
+   ```
+
+2. **Update preference system** after video is delivered:
+
+   **Layer 1 — Core preferences** (`~/.claude/renoise/preferences.json`):
+   Update preferred_styles (frequency-sorted), ratio, dialogue_tone, avoid list, session count.
+   Write the entire JSON file (overwrite, not append).
+
+   **Layer 2 — Style profile** (`~/.claude/renoise/style-profile.md`):
+   If the user expressed a new preference or custom style blend, update the relevant category section.
+   Only write extracted insights, not raw conversation.
+
+   **Layer 3 — History** (`~/.claude/renoise/history/YYYY-MM.md`):
+   Append a brief entry (5 lines max): date, project name, category, style chosen, result.
+
+   **Initialize preference files** if they don't exist:
+   ```bash
+   mkdir -p ~/.claude/renoise/history
+   [ -f ~/.claude/renoise/preferences.json ] || echo '{}' > ~/.claude/renoise/preferences.json
+   [ -f ~/.claude/renoise/style-profile.md ] || echo '# Style Profile' > ~/.claude/renoise/style-profile.md
+   ```
+
+## Examples
+
+### Example 1: Product video (common)
+User: "I have photos of my new sneakers, help me make a video"
+1. Phase 1: Analyze sneaker images via `gemini-gen` skill → extract product type, colors, selling points
+2. Phase 2: Suggest Minimal Showcase / Dynamic Sports / Lifestyle Vlog with adapted descriptions
+3. User picks "Dynamic Sports"
+4. Phase 3: Generate 15s video prompt with fast tracking, high-energy BGM, beat-synced cuts
+5. Phase 4: Upload product image, submit task, wait for result
+
+### Example 2: Short drama (no specialized skill)
+User: "I want a 15-second suspense clip about a mysterious package"
+1. Phase 1: No images — text-only creative brief, discover no matching specialized skill
+2. Phase 2: Suggest Suspense & Twist / Dramatic Conflict / Warm & Heartfelt
+3. User picks "Suspense & Twist"
+4. Phase 3: Director generates video prompt directly (cold tones, slow push-in, surprise ending)
+5. Phase 4: Submit text-to-video task
+
+### Example 3: User has style preferences
+User: "Make another product video for my candle" (returning user)
+1. Phase 1: Read preferences.json → user historically prefers "Calm & Aesthetic", dislikes "hard-sell tone"
+2. Phase 2: Rank "Calm & Aesthetic" first, also suggest "Premium Commercial" and "Lifestyle Vlog"
+3. Faster iteration because preferences pre-filter the options
+
+## Troubleshooting
+
+### PrivacyInformation error
+**Cause**: Uploaded image contains realistic human face.
+**Solution**: Switch to text-to-video. Describe the person's appearance in the prompt instead of uploading their photo.
+
+### Insufficient credits (402)
+**Cause**: Renoise balance too low.
+**Solution**: Run `renoise-cli.mjs credit me` to check balance, inform user of current balance and estimated cost.
+
+### Skill routing confusion
+**Cause**: User intent unclear between director vs specialized skill.
+**Solution**: Default to director flow. If the user specifically mentions "TikTok" or "ecommerce", route to tiktok-content-maker.
+
+### Video generation takes too long
+**Cause**: 15s videos typically need 5-10 minutes.
+**Solution**: Set `--timeout 600` (10 min). For longer waits, use `--timeout 900`.
+
+## Performance Notes
+
+- Take your time to analyze the user's materials thoroughly
+- Quality of style suggestions is more important than speed
+- Do not skip the preference system read/write steps
+- Always read the full video-capabilities.md before writing prompts