reelkit-cli 0.1.2 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reelkit-cli",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "CLI and Claude skill for making short-form video with a shared asset library.",
   "license": "MIT",
   "author": "Daniel Livshin",

package/skill/reference/motion-design.md

@@ -78,7 +78,7 @@ Hook (first 1.5 s: the boldest visual and claim) → context (one line, one visu
 - Grain or paper texture is one static layer above everything, outside the camera group. Inside a zooming group it is slow and the grain swells into blotches.
 
 ## Banned, because they read as AI-made or cheap
-These hold unless the look chosen in `reference/styles.md` names an exception (a showreel look uses flat colour fields; the glowing-branches look uses glow on its lines).
+These hold unless the look chosen in `reference/styles.md` names an exception (a showreel look uses flat colour fields; the neon look uses glow on its hero element and lines).
 
 Flat solid backgrounds, opacity-only fades, everything entering at once, rainbow or multi-stop gradients on text and UI, particles and sparkles, glows on interface chrome, emoji as graphics, bouncy easing, gratuitous 3D flips, a centred title on a plain gradient, mixed icon styles, lorem ipsum, and anything that looks like a stock template.
 

package/skill/reference/styles.md

@@ -19,40 +19,41 @@ Every look belongs to one mode. The mode decides which rules in `reference/motio
 
 **Showreel** (openers, announcements, anything that must stop the scroll)
 - Hard cuts on the beat between full-colour backgrounds; type that fills the frame. Flat solid colour fields are right here.
-- The camera never stops: a slow push, a degree or two of rotation, a short shake on each hit.
+- The camera never stops: a slow push, a slight turn, a short shake on each hit.
 - No frame sits still longer than a third of a second, except the final hold.
 - At most three full-screen flashes in any second, and never a red strobe. This is a safety rule, not a taste rule.
 
 ## The catalogue
+Each look is built from what the kit and the shared library already hold, so most of it is found with one search rather than written from nothing. The search words are suggestions for `reelkit assets search "<words>" --kind component`.
 
-### 1. One shape, many interfaces (restrained)
-**When:** a product or app should look polished. **How:** a single rounded shape morphs through button, loader, player, toggle, tabs and chart; its width, height and radius move together on one spring, and the leading edge of a slider or toggle moves on a faster spring than the trailing edge so it stretches. A pointer, if shown, drives values directly while it drags and springs back on release. **Forbidden:** a cut between states, more than one accent colour.
+### 1. Product walkthrough (restrained)
+**When:** an app, a site or a feature, with the user's real screenshots. **How:** the screenshot sits in a device or browser frame (search "phone mockup", "browser mockup") on a calm mesh background; interface moments arrive as real-looking parts (search "notification", "chat messages", "alert dialog", "status toast"); a pointer label names one thing at a time (search "callout"). One frame stays on screen and the content inside it changes. **Forbidden:** an invented screen, more than one callout at once, glow on interface parts.
 
-### 2. Giant type on colour fields (showreel)
-**When:** an opener or a strong message of 3 to 6 words. **How:** one or two words per frame, a hard cut to a new full colour on each beat, each word entering a different way (a scale hit, widening from tight to wide, a short slide, a design-tool selection box that snaps on). End with the whole message together, held at least 1.5 seconds. **Forbidden:** soft gradients, outlined words, a still frame.
+### 2. Numbers that land (restrained)
+**When:** results, growth, a comparison, anything with figures from the narration. **How:** one figure or one chart per scene (search "statistic counter", "line chart", "bar chart", "pie chart", "radial gauge"); the number counts up and finishes before the scene's midpoint; a before and after sits side by side (search "comparison"). The payoff number gets the biggest move of the video. **Forbidden:** any figure that is not in the plan, two charts in one frame, decorative data.
 
-### 3. A word made of particles (showreel)
-**When:** revealing a name or brand, or a closing wow. **How:** sample the word's pixels once, then move each particle between targets (word, sphere, swirl, word) as a function of the frame; draw on a canvas, not thousands of elements. The word must be readable again at the end and held half a second. **Forbidden:** per-frame randomness.
+### 3. Headline hits (showreel)
+**When:** an opener, a launch, a message of a few words that must stop the scroll. **How:** one or two words fill the frame (search "kinetic title"), hard cuts to a new full colour on the beat, each word entering a different way, and the whole message together at the end, held. The camera keeps a slow push the whole time. **Forbidden:** soft gradients, outlined words, a still frame before the final hold.
 
-### 4. A field of blocks (showreel)
-**When:** an energetic background behind a headline, or anything about data. **How:** a grid of blocks rising and falling as a travelling wave, one accent object moving across it, the headline on a dark soft patch above. All blocks jump on the last word. **Forbidden:** letting the background out-shout the text.
+### 4. Cinematic story (restrained)
+**When:** a mood, a place, a story told by a voice. **How:** generated or reused pictures with a slow move across them, a film grade and grain over everything, a poster-style title to open (search "cinematic title"), a film overlay if it suits (`--kind overlay`, search "film"). Few words on screen; the captions carry the text. **Forbidden:** interface parts, bright accent colours, fast cuts.
 
-### 5. Rings of words (showreel)
-**When:** a list of values, services or topics. **How:** each line of words bends into a ring; rings turn at different slow speeds inside one another with the title in the centre. Read every ring in a preview frame. **Forbidden:** more than about ten words, rings too small to read.
+### 5. Neon and night (showreel)
+**When:** technology, AI, nightlife, anything that should feel electric. **How:** near-black background, one glowing colour, a sign-like title (search "neon title"), thin lines that draw themselves. Glow is the look here, so it is allowed, on the hero element and the lines only. **Forbidden:** glow on body text, a second glowing colour, flashes above the limit.
 
-### 6. Hand-drawn character (restrained)
-**When:** a personal, warm or funny message. **How:** a simple pencil character on paper; lines boil slightly by switching between two or three hand-offset versions every few frames (chosen by frame number, never at random), a speech bubble in a handwriting face. **Forbidden:** clean vector precision, more than two colours beside the pencil.
+### 6. Notebook (restrained)
+**When:** a personal, warm or teaching tone. **How:** a paper background with faint static grain, a handwriting or rounded face, hand-drawn arrows, circles and underlines that draw themselves onto the point being made (search "hand drawn arrow circle underline"). Slight wobble comes from switching between two or three drawn versions by frame number, never at random. **Forbidden:** crisp interface chrome, more than two ink colours.
 
-### 7. Storybook explainer (restrained)
-**When:** teaching how something works, in 3 to 5 steps. **How:** flat illustration with rounded shapes, one dark outline colour, a paper background and faint static grain. The camera moves into the object and a round cutaway opens to show the inside, instead of cutting to a new scene. Each step gets a short label beside the action with a thin leader line, on screen at least 1.3 seconds; end on a 2 to 4 word title over the result. **Forbidden:** realistic shadows, strong gradients, labels covering the drawing.
+### 7. Step by step (restrained)
+**When:** a process, a how-to, a recipe, three to five steps. **How:** a numbered list that builds one step at a time (search "steps process"), or one drawing the camera moves through, stopping at each step with a short label beside the action. Each label stays at least 1.3 seconds; end on a short title over the result. **Forbidden:** all steps appearing at once, labels covering the thing they describe.
 
-### 8. Glowing branches (showreel)
-**When:** AI, science, the moment an idea is born. **How:** lines of light that grow and fork like nerve cells, a spark running along them, on near-black. Glow is the look here, so it is allowed, on the lines only. **Forbidden:** glow on text, flashes above the limit.
+### 8. People and proof (restrained)
+**When:** a testimonial, an introduction, a creator talking, social proof. **How:** the person's name and role in a lower third (search "name lower third"), a quote card with its stars (search "quote testimonial"), a follow line to close (search "social handle", "cta button"). Quotes and names come from the user, word for word. **Forbidden:** an invented quote, rating or follower count.
 
-### 9. Sketch to object (restrained)
-**When:** showing how a physical thing is built. **How:** a pencil technical drawing draws itself line by line, gains colour and shade, then does what it was built to do. **Forbidden:** skipping the drawing stage; it is the point.
+### 9. Over footage (either mode)
+**When:** the user supplied their own video. **How:** the footage is the picture; graphics are guests. One overlay at a time, clear of the speaker's face; a small punch-in on each sentence's key word; lower thirds and callouts from the library; captions always. **Forbidden:** covering the face, a graphic left on screen after its sentence, zooms on footage that already has its own.
 
-### 10. Logo reveal (either mode)
+### 10. Logo sting (either mode)
 **When:** an opener or end card, from the user's own logo file. **How:** build toward the logo from its own shapes and colours and land on it exactly as supplied, held at least 1.5 seconds. **Forbidden:** redrawing, recolouring or stretching the logo; anyone else's logo or trademark.
 
 ## Your own