@cliangdev/conductor 0.31.1 → 0.32.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (58) hide show
  1. package/assets/claude/agents/conductor-content-art-director.md +30 -7
  2. package/assets/claude/agents/conductor-content-creative-director.md +7 -2
  3. package/assets/claude/agents/conductor-content-ideator.md +9 -3
  4. package/assets/claude/agents/conductor-content-scriptwriter.md +12 -4
  5. package/assets/claude/commands/conductor/content.md +3 -1
  6. package/assets/claude/commands/conductor/creative.md +14 -8
  7. package/assets/claude/skills/conductor-content-studio/SKILL.md +47 -17
  8. package/assets/claude/skills/conductor-content-studio/references/capabilities.md +11 -3
  9. package/assets/claude/skills/conductor-content-studio/references/design-critique.md +52 -0
  10. package/assets/claude/skills/conductor-content-studio/references/idea-template.md +3 -3
  11. package/assets/claude/skills/conductor-content-studio/references/layout-guide.md +52 -0
  12. package/assets/claude/skills/conductor-content-studio/references/publish-pack-template.md +8 -3
  13. package/assets/claude/skills/conductor-content-studio/references/rubric.md +6 -0
  14. package/assets/claude/skills/conductor-content-studio/references/slideshow-formats.md +121 -0
  15. package/assets/claude/skills/conductor-creative/SKILL.md +42 -8
  16. package/assets/claude/skills/conductor-creative/references/brand-kit-setup.md +3 -1
  17. package/assets/claude/skills/conductor-creative/references/design-critique.md +52 -0
  18. package/assets/claude/skills/conductor-creative/references/hooks.md +47 -0
  19. package/assets/claude/skills/conductor-creative/references/layout-guide.md +52 -0
  20. package/assets/claude/skills/conductor-creative/references/slideshow-formats.md +121 -0
  21. package/assets/claude/skills/conductor-publisher/SKILL.md +2 -2
  22. package/assets/cli-manifest.json +5 -0
  23. package/assets/fonts/OFL.txt +93 -0
  24. package/assets/fonts/tiktok-sans-600.ttf +0 -0
  25. package/assets/fonts/tiktok-sans-700.ttf +0 -0
  26. package/assets/fonts/tiktok-sans-800.ttf +0 -0
  27. package/dist/lib/plugin-assets.d.ts.map +1 -1
  28. package/dist/lib/plugin-assets.js +7 -0
  29. package/dist/lib/plugin-assets.js.map +1 -1
  30. package/dist/lib/slideshow/compose.d.ts +37 -0
  31. package/dist/lib/slideshow/compose.d.ts.map +1 -0
  32. package/dist/lib/slideshow/compose.js +160 -0
  33. package/dist/lib/slideshow/compose.js.map +1 -0
  34. package/dist/lib/slideshow/css.d.ts +3 -0
  35. package/dist/lib/slideshow/css.d.ts.map +1 -0
  36. package/dist/lib/slideshow/css.js +103 -0
  37. package/dist/lib/slideshow/css.js.map +1 -0
  38. package/dist/lib/slideshow/html.d.ts +20 -0
  39. package/dist/lib/slideshow/html.d.ts.map +1 -0
  40. package/dist/lib/slideshow/html.js +192 -0
  41. package/dist/lib/slideshow/html.js.map +1 -0
  42. package/dist/lib/slideshow/index.d.ts +4 -0
  43. package/dist/lib/slideshow/index.d.ts.map +1 -0
  44. package/dist/lib/slideshow/index.js +4 -0
  45. package/dist/lib/slideshow/index.js.map +1 -0
  46. package/dist/lib/slideshow/spec.d.ts +109 -0
  47. package/dist/lib/slideshow/spec.d.ts.map +1 -0
  48. package/dist/lib/slideshow/spec.js +167 -0
  49. package/dist/lib/slideshow/spec.js.map +1 -0
  50. package/dist/mcp/index.d.ts +403 -0
  51. package/dist/mcp/index.d.ts.map +1 -1
  52. package/dist/mcp/index.js +21 -0
  53. package/dist/mcp/index.js.map +1 -1
  54. package/dist/mcp/tools/slideshow.d.ts +42 -0
  55. package/dist/mcp/tools/slideshow.d.ts.map +1 -0
  56. package/dist/mcp/tools/slideshow.js +77 -0
  57. package/dist/mcp/tools/slideshow.js.map +1 -0
  58. package/package.json +1 -1
@@ -0,0 +1,121 @@
1
+ <!-- Keep identical to the copy in the other creative skill (conductor-creative / conductor-content-studio references/slideshow-formats.md). Skills install independently and cannot reference each other. -->
2
+ # Slideshow formats
3
+
4
+ For organic posts: a native-looking photo slideshow (TikTok photo post, Instagram carousel) that
5
+ promotes an app or product by being worth watching first. Build it with `compose_slideshow`, then
6
+ post it as a CAROUSEL Creative. Ads use the brand layouts (STILL) instead; this is not the ad path.
7
+
8
+ Branding is light: no logo, badge or offer on the slides. The product appears as the payoff, not the
9
+ opener.
10
+
11
+ ## Post anatomy
12
+
13
+ Aim for 5 to 7 slides. Each slide has one job.
14
+
15
+ 1. **Slide 1, the hook.** A human tension or a result people want to keep. Never a feature, the
16
+ product name or a price.
17
+ 2. **Middle slides, the value.** The part people save or send: the list, the plan, the fix, the story
18
+ beat. Saves and sends carry a post beyond followers.
19
+ 3. **Slide N-1, the payoff.** The product in use on a real screenshot (a `screen` slide, optionally
20
+ with `callouts`) plus one plain mention, such as "I keep mine in <App>".
21
+ 4. **Last slide, the ask.** A save or follow ask: "Save this. Link in bio."
22
+
23
+ ## Slide types
24
+
25
+ Every slide takes `type` (default `photo`), an optional background (`bg` path, `bgColor`, `blur`,
26
+ `grade`, `grain`, `dim`) and `texts`. Each text is `{t, y, fs, style}`; the first text of a slide
27
+ needs `y`, and later texts without `y` stack under the previous one.
28
+
29
+ | Type | For | Key fields | Use when |
30
+ |---|---|---|---|
31
+ | `photo` | A full-bleed photo with text on it | `bg`, `pos`, `grade`, `grain`, `dim`, `texts` | The default hook, list or story slide |
32
+ | `screen` | A real app screenshot in a phone frame | `shot`, `phoneY`, `pw`, `cropH`, `callouts [{x, y, label}]`, `bg`, `blur`, `texts` | The payoff slide (N-1); callouts point at what to notice |
33
+ | `notes` | A Notes-app page | `title`, `date`, `items` (strings or `{t, done, strike}`), `paras` | A plan, checklist or "what I do now" |
34
+ | `messages` | A chat thread | `bubbles [{from: "me"|"them", t}]` | Doubt or conflict: what someone said to you |
35
+ | `grid` | A wall of small photos | `cols`, `gridTop`, `photos [{src, x, badge, cap, restore}]` | "Everything you saved and never used"; one tile `restore`d for the close |
36
+ | `stack` | Photos stacked in a column | `photos [{src, label}]` | A before/after with `label`s ("Before", "After") or a short comparison |
37
+ | `tier` | A tier list | `rows [{k, c, items}]`, `ts` | Ranking, "what's worth it and what isn't" |
38
+ | `week` | A week planner | `days [{d, t, img, icon, fog}]` | A routine or plan across days |
39
+ | `receipt` | A till receipt | `head`, `sections [{h, items}]`, `count` | A tally or breakdown; `count` must be a real figure |
40
+ | `placard` | A museum-style label over a photo | `bg`, `ex`, `title`, `y`, `lines [{k, v}]` | A deadpan, collectible-feeling item card |
41
+
42
+ Text `style`: `box` (white rounded box, TikTok's own text look), `dark` (dark box), `stroke` (white
43
+ text, black outline), `sub` (smaller subline).
44
+
45
+ ### Example spec
46
+
47
+ A five-slide "stop doing X" post. Paths are relative to the spec file or absolute.
48
+
49
+ ```json
50
+ {
51
+ "id": "stop-over-saving",
52
+ "slides": [
53
+ {"type": "photo", "bg": "photos/desk.jpg", "grade": true, "grain": true,
54
+ "texts": [{"t": "Stop saving things you will never open.", "y": 30, "fs": 76}]},
55
+ {"type": "messages",
56
+ "bubbles": [{"from": "them", "t": "did you ever look at that thing you saved?"},
57
+ {"from": "me", "t": "define look"}],
58
+ "texts": [{"t": "Be honest.", "y": 20}]},
59
+ {"type": "notes", "title": "What I do now", "date": "Today",
60
+ "items": ["Save one thing", {"t": "Open it within a day", "done": true}, "Delete the rest"]},
61
+ {"type": "screen", "shot": "shots/home.png", "phoneY": 40, "pw": 600,
62
+ "callouts": [{"x": 50, "y": 30, "label": "one tap"}],
63
+ "texts": [{"t": "I keep mine in <App>.", "y": 18}]},
64
+ {"type": "photo", "bg": "photos/desk.jpg", "dim": true,
65
+ "texts": [{"t": "Save this.", "y": 32, "fs": 80}, {"t": "Link in bio.", "style": "sub"}]}
66
+ ]
67
+ }
68
+ ```
69
+
70
+ ## Hook archetypes
71
+
72
+ Pick one per post and name it in the idea. Change one thing per post so results are comparable.
73
+
74
+ | Archetype | Slide 1 | Slides |
75
+ |---|---|---|
76
+ | Saved-but-never-used guilt | "Camera-roll graveyard." | `grid` (one tile `restore`d at the end), `photo`, `screen`, ask |
77
+ | Doubt or conflict | What someone said to you (needs a true story) | `messages`, `photo`, `notes`, `screen`, ask |
78
+ | Stop doing X | "Stop doing X." | `photo` with the reason per slide, `screen`, ask |
79
+ | Numbered list | "5 things worth saving" | `photo` per item, `screen` last, ask |
80
+ | Tier list | "Ranking everything I tried" | `tier`, `photo` close-ups, `screen`, ask |
81
+ | Notes-app plan | "My plan for the week" | `notes`, `week`, `screen`, ask |
82
+ | POV | "POV: you finally did it" | `photo` (hands or a real scene), `screen`, `photo`, ask |
83
+ | Before / after | "Week 1 vs week 4" | `stack` with `label`s, `photo`, `screen`, ask |
84
+
85
+ ## Text rules
86
+
87
+ - Native box text (`box`) or white text with a black stroke (`stroke`); centred, bold, sans.
88
+ - At most 8 words a line and 3 lines a box.
89
+ - Keep text between about y 16 and y 75 (percent of the 9:16 frame). That survives the 4:5 Instagram
90
+ cut and the platform UI (top bar, bottom caption, right button column).
91
+ - The first text of every slide needs `y`.
92
+ - Read the composer's `checks`; an `error` severity blocks the preview.
93
+
94
+ ## Honesty and brand
95
+
96
+ - No logo, badge or offer on the slides. The offer, if any, goes in the caption.
97
+ - No invented numbers or claims. A placeholder count (a receipt `count`, "312 saved") must be
98
+ replaced with a real figure, or the line rewritten without one.
99
+ - Real screenshots only for `screen` slides; never mock up the product.
100
+ - A generated photo needs the platform's AI label turned on. Turn on the platform's branded-content
101
+ or "your brand" setting for a brand's own promotional post.
102
+ - A conflict or testimonial story must be true, and anyone shown or quoted must be real and agree.
103
+
104
+ ## Getting the download
105
+
106
+ Captions on TikTok and Instagram cannot hold clickable links, so do not rely on one:
107
+
108
+ - Name the app in the caption and on slide N-1, so it can be searched ("search <App> in the App
109
+ Store").
110
+ - Pin a comment that says where to find it.
111
+ - Keep the link in the profile bio.
112
+ - Repost the post to Instagram Stories with a link sticker.
113
+
114
+ ## Flow
115
+
116
+ 1. Write the spec (`slideshow-spec.json`); call `compose_slideshow({specPath})`.
117
+ 2. If `passed` is false, fix every `error` check and compose again. Warnings are advisory.
118
+ 3. `preview_creative_draft({kind: "CAROUSEL", slidePaths, caption, slideAltText})` using the
119
+ returned `slidePaths` (`9x16` for TikTok, `4x5` for Instagram). Look at the contact sheet and show
120
+ it.
121
+ 4. Only after the person approves, `commit_creative_draft`.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: conductor-creative
3
- description: Creates on-brand marketing creative through the Conductor MCP tools — static ads and short videos alike, rendered locally on this machine as a draft, checked by eye and approved before anything is saved to Conductor. Covers a photo-plus-headline ad at every enabled placement (e.g. TikTok/Reels 9:16, Instagram feed 4:5, Facebook 1:1); a short video made from a still photo or an existing clip (animated text, zoom/pan, background music, a TikTok/Reels/Shorts-ready cut); posting a finished video as-is; posting finished images as-is (a carousel or single still designed elsewhere, or an existing media set); a story or carousel sequence; a lettered headline/hook variant for testing; and, when a workspace's Brand Kit has never been set up, setting one up first (colours, font, logo, copy rules) from a website, a brand doc, or a few direct answers. Use when asked to make, design, write or export a social ad, a promo image, a short-form video, an animated ad, or to configure/update a project's brand.
3
+ description: Creates on-brand marketing creative through the Conductor MCP tools — static ads and short videos alike, rendered locally on this machine as a draft, checked by eye and approved before anything is saved to Conductor. Covers a photo-plus-headline ad at every enabled placement (e.g. TikTok/Reels 9:16, Instagram feed 4:5, Facebook 1:1); a short video made from a still photo or an existing clip (animated text, zoom/pan, background music, a TikTok/Reels/Shorts-ready cut); posting a finished video as-is; an organic post as a native slideshow (compose_slideshow, then a CAROUSEL); posting finished images as-is (a carousel or single still designed elsewhere, or an existing media set); a story or carousel sequence; a lettered headline/hook variant for testing; and, when a workspace's Brand Kit has never been set up, setting one up first (colours, font, logo, copy rules) from a website, a brand doc, or a few direct answers. Use when asked to make, design, write or export a social ad, a promo image, a short-form video, an animated ad, or to configure/update a project's brand.
4
4
  user-invocable: true
5
5
  allowed-tools: mcp__conductor__*, AskUserQuestion, Read, Glob, Grep, WebFetch
6
6
  ---
@@ -25,6 +25,16 @@ Creative, no upload — then the person looks at it, and only on their approval
25
25
  `commit_creative_draft` upload the media, save the Creative and do the full render. Never commit a
26
26
  draft the person has not seen and approved.
27
27
 
28
+ ## Which path
29
+
30
+ - **An organic post or slideshow** (TikTok or Instagram photo post, no paid placement): build native
31
+ slides with `compose_slideshow`, then post them as a CAROUSEL Creative. Read
32
+ `references/slideshow-formats.md` first; it covers the spec, archetypes, text rules and the flow.
33
+ No logo, badge or offer goes on the slides, and the brand layouts below do not apply.
34
+ - **An ad** (a paid placement, or art that must carry the brand lockup and CTA): use the brand
35
+ layouts (STILL) as described below.
36
+ - **A video**, a **clip** or **finished images**: see their sections below.
37
+
28
38
  ## How to make a Creative
29
39
 
30
40
  ### 1. Read the brand
@@ -50,10 +60,15 @@ a person through exactly this when invoked with no brand set up yet, if you'd ra
50
60
  Lead with whatever the brand's own message hierarchy puts first — the job the product does end to
51
61
  end, not a secondary feature. A supporting capability is proof, not the headline.
52
62
 
63
+ Then start from a concept: one visual idea, plus the format that carries it. Not "a headline on a
64
+ photo". Decide what the viewer should see happening (the product doing its job, or a concrete scene
65
+ of the problem or the result) before you write a line of copy.
66
+
53
67
  ### 3. Write the headline
54
68
 
55
69
  Prefer an approved line from the Knowledge page verbatim. Otherwise write one that names something
56
- real and specific, not a generic claim.
70
+ real and specific, not a generic claim. Write 6 to 10 candidates across hook types, score them and
71
+ keep the best two or three: `references/hooks.md`.
57
72
 
58
73
  If the Brand Kit's `accentPhraseRequired` is true, mark exactly one phrase per headline with
59
74
  asterisks: `Every saved link, *finally usable*.` Never zero, never two — `preview_creative_draft`,
@@ -98,6 +113,13 @@ about 40-50 images uses a week), or skip and use a library photo. Only on an exp
98
113
  AI label applies. A 1024x1536 image cropped to 9:16 may draw the "soft, upscaled photo" warning:
99
114
  mention it, don't fight it.
100
115
 
116
+ **The photo shows the product doing its job**, or a concrete scene of the problem or the result: a real
117
+ screen or shot (pass it in `referenceImagePaths`, or use a library photo of the product in use). Stock
118
+ poses (a person smiling at a phone on a couch, a mug, a generic laptop) and empty decorative scenes (a
119
+ sunlit counter with nothing happening) are out. A generated still cannot show an invented product
120
+ screen; real product shots come in as references. Ask for `count: 2` or `3` when you want options
121
+ (each image costs about $0.05 on the API route; on the Codex route each uses weekly quota, so ask first).
122
+
101
123
  **Every generated photo gets the realism check** in `references/realism-check.md` before it is used:
102
124
  it must not look AI-made (waxy surfaces, duplicated objects, warped hands, mushy detail). On a fail,
103
125
  regenerate with a prompt that names the fix, at most twice; if the third still fails, say what looks
@@ -110,12 +132,17 @@ a logo or a claim burned into its pixels, and no automated check can see that
110
132
  of this skill's silent failure modes (the full list is below). A human or a prior pass marks a bad
111
133
  photo `blocked`; if you notice one that should be, say so rather than using it anyway.
112
134
 
113
- Match the crop to the subject: a layout that lays copy over the photo (e.g. `bleed`) puts a face in
114
- the top third in collision with the headline — prefer a layout that keeps the photo and copy on
115
- separate panels (e.g. `stacked`) for those.
135
+ Match the crop to the subject. A layout that lays copy over the photo (`bleed`) can put a face in
136
+ collision with the headline: move the subject with `focalOverride` when the crop has room, pick a
137
+ photo with the subject lower, or use `card`, which keeps the photo and copy on separate panels. Pick the layout with `references/layout-guide.md`
138
+ (default `bleed` when 9:16 is enabled; never `stacked` or `split` there, and never rely on the
139
+ registry default).
116
140
 
117
141
  ### 6. Preview the draft
118
142
 
143
+ Preview two or three genuinely different drafts: a different hook, layout or photo, not three crops of
144
+ one idea. Show them together and let the person pick. Run the critique in step 7 on each first.
145
+
119
146
  `preview_creative_draft` with the Brand Kit (if not the default), layout, theme, photo (`photoPath`
120
147
  for a local file, `photoId` for one already in the library), headline, body, caption and alt text.
121
148
  It renders a contact sheet on this machine and returns it as an image, with the `draftDir` it wrote
@@ -169,9 +196,13 @@ the headline or layout of a saved Creative clears pinned sizes unless you send t
169
196
  (`passed: true`) catch text spilling out of a safe zone, a font that failed to load, a photo that
170
197
  never decoded, or contrast below the accessible minimum — not whether the headline reads at a
171
198
  glance, whether the accent phrase falls on the words that carry the meaning, or whether the copy is
172
- sitting on the subject's face. Judge those yourself from the image `preview_creative_draft` hands
173
- back. If the copy collides with the photo, switch layout (see step 5) and preview again rather than
174
- shrinking text until it technically fits.
199
+ sitting on the subject's face.
200
+
201
+ Score the draft with `references/design-critique.md` before the person sees it: six criteria, 1 to 5,
202
+ at phone size. Any score below 3 means fix and re-render, at most twice; then show the best draft with
203
+ one honest line on what is still weak. Show the scores in one compact line with the preview. If the
204
+ copy collides with the photo, change the layout or `focalOverride` (step 5) rather than shrinking text
205
+ until it technically fits.
175
206
 
176
207
  Only once `passed` is true, show the image to the person and ask with `AskUserQuestion` —
177
208
  **Approve & upload**, **Request changes**, **Stop**. If `passed` is false you are not at this step
@@ -252,6 +283,9 @@ broadly.
252
283
 
253
284
  ## Finished images (carousel or single still)
254
285
 
286
+ Slides made by `compose_slideshow` take this same CAROUSEL route: pass its `slidePaths` to
287
+ `preview_creative_draft` (see `references/slideshow-formats.md`).
288
+
255
289
  When the slides are already designed (Figma exports, your own renderer, device-framed screenshots)
256
290
  there is nothing for the brand layout to do, so use a CAROUSEL Creative: finished images posted
257
291
  as-is. A one-slide CAROUSEL is a finished still. For text on a photo that Conductor should lay out,
@@ -36,6 +36,8 @@ making anything:
36
36
  font (if any), the CTA claim, and any lines that must run verbatim. Keep it to one AskUserQuestion
37
37
  batch, not a long interview.
38
38
  - Once confirmed, call `update_brand_kit` with whatever was gathered. If a logo file or URL is
39
- available, `upload_brand_image` for the `mark` slot at least. Verify with `get_brand_kit` —
39
+ available, `upload_brand_image` for the `mark` slot at least. Warn before setting a badge image or
40
+ a `ctaClaim`: both render on every still, which makes each one read as a banner ad. Suggest putting
41
+ a trial offer or similar in the caption instead. Verify with `get_brand_kit` —
40
42
  `configured` should now read `true`.
41
43
  - **Skip for now**: proceed; the skill below will render against the default kit as given.
@@ -0,0 +1,52 @@
1
+ <!-- Keep identical to the copy in the other creative skill (conductor-creative / conductor-content-studio references/design-critique.md). Skills install independently and cannot reference each other. -->
2
+ # Design critique
3
+
4
+ Passing checks does not make an ad good. `checks` and `passed` cover text spill, safe zones, contrast
5
+ and fonts. This critique covers craft, and it runs before the person sees a draft.
6
+
7
+ Look at the preview image at phone size. Vision models miss small typography details, so don't
8
+ claim to have judged kerning or hairline spacing; judge what is visible at a glance.
9
+
10
+ ## Which criteria apply
11
+
12
+ Stills, ads and brand-layout creatives use the six criteria below. An organic slideshow (a
13
+ `compose_slideshow` CAROUSEL) uses the five slideshow criteria further down instead, because it is
14
+ meant to look native, not like an ad.
15
+
16
+ ## Score each criterion 1 to 5 (stills and ads)
17
+
18
+ Score each one on its own, against the description, not against another draft.
19
+
20
+ 1. **Thumb-stop**: would it stop a scroll? One clear focal point and a hook you get in a second.
21
+ 2. **Headline size and position**: readable at thumbnail size, not crammed into a corner or a thin strip.
22
+ 3. **Empty space**: no dead slab or empty panel. Space that is there on purpose is fine; a leftover band is not.
23
+ 4. **Photo and copy together**: copy is not on the subject's face, and the photo carries the concept rather than decorating it.
24
+ 5. **Product shown**: the product, or the result it gives, is visible. A stock pose or an empty scene scores 1 or 2.
25
+ 6. **Not a banner ad**: it does not read as logo + badge + tagline stacked on a picture.
26
+
27
+ ## Act on the scores
28
+
29
+ - Any criterion below 3: fix it (copy, layout, `focalOverride`, `typeOverrides`, the photo) and
30
+ render again. At most two fix rounds.
31
+ - Still below 3 after that: show the best version with one honest line on what is weak.
32
+ - Comparing variants: score each on its own first. Use a side-by-side comparison only to break a
33
+ tie, and judge it in both orders (first vs. second, then second vs. first); if the order changes
34
+ the winner, call it a tie. Pairwise judging favours whichever is shown first.
35
+
36
+ ## Show the scores
37
+
38
+ One compact line next to the preview, for example:
39
+ `Craft: thumb-stop 4, headline 4, space 3, photo+copy 4, product 3, not-banner 4. Weakest: product is implied, not shown.`
40
+
41
+ ## Slideshow criteria (organic slideshows)
42
+
43
+ Look at the contact sheet: slide 1 at full size, then the slides in order. Score each 1 to 5.
44
+
45
+ 1. **Slide 1 stops the scroll**: a human tension or a result people want, in a line a stranger gets in a second. A feature, the app name or a price scores 1 or 2.
46
+ 2. **Each slide earns the next swipe**: every slide has one job and a reason to go on; no filler slide, no slide that repeats the last.
47
+ 3. **People would save or send it**: the middle slides hold something to keep or to send to a named person.
48
+ 4. **The app is the payoff, not the opener**: it appears on slide N-1 on a real screenshot with one plain mention, never on slide 1 and never as a logo, badge or offer.
49
+ 5. **Native look**: text boxes and photos feel like a person's post. Banner-ad signs (a logo lockup, a badge, a tagline stack, a call-to-action button) score 1 or 2.
50
+
51
+ Act on the scores as below. Show them in one line, for example:
52
+ `Slideshow: scroll-stop 4, next-swipe 3, save/send 4, app-as-payoff 4, native 5. Weakest: slide 3 repeats slide 2.`
@@ -0,0 +1,47 @@
1
+ <!-- Used by conductor-creative only. -->
2
+ # Hooks: writing the headline
3
+
4
+ A hook is the line that makes a thumb stop. A tagline says what the brand is; a hook names a moment,
5
+ an object or a number the viewer recognises. Write several, score them, keep the best.
6
+
7
+ ## Write 6 to 10 candidates
8
+
9
+ Mix the types. Do not write ten versions of one.
10
+
11
+ - **Situation / POV**: the moment the viewer is in. "You have 40 tabs open and no idea which one has the quote."
12
+ - **Mechanism**: how it works, in one line. "Paste a link, get a summary and a reminder."
13
+ - **Enemy**: the thing it replaces or kills. "The spreadsheet nobody updates."
14
+ - **Exact result**: a specific number or time. "Invoices sent in 4 minutes, not 4 days."
15
+ - **Concept**: a visual metaphor the image carries, with the line finishing the thought. A photo of one
16
+ chair at a long empty table, "Standups, minus the standing."
17
+
18
+ An approved line from the Knowledge page still wins when one fits. Quote it verbatim; use the
19
+ candidates to find the angle around it or when none fits.
20
+
21
+ ## Score each 1 to 5
22
+
23
+ Same scale wording as the content studio's hook strength: 1 is a greeting or generic claim, 3 a clear
24
+ promise that could open any account's post, 5 a specific, surprising line a stranger gets in a second.
25
+
26
+ - **Hook strength**: would it stop a thumb?
27
+ - **Specificity**: does it name a moment, an object or a number?
28
+ - **Competitor test**: could a competitor run this unchanged? If yes, it fails; rewrite or drop it.
29
+
30
+ Exact numbers read as more credible than round ones: "11 minutes" over "10 minutes". One selling point
31
+ per line, written the way a person would say it.
32
+
33
+ ## Keep 2 or 3
34
+
35
+ Keep the best two or three, and aim for about 8 words or fewer on the artwork. The rest are spare
36
+ hooks for variants (`variantOf`) or the caption. Run the chosen line through the brand's copy rules.
37
+
38
+ ## Tagline vs. hook
39
+
40
+ | Tagline | Hook |
41
+ |---|---|
42
+ | Smarter scheduling for busy teams | The meeting that could have been a link, gone |
43
+ | Fresh food, delivered | Dinner at your door before the oven is warm |
44
+ | Save money on energy | Your bill dropped $38 last month. Ours too. |
45
+ | Learn faster with AI | Fluent in 30 days, or the next month is free |
46
+
47
+ Check the last row against the brand's claims rules before using a line like it: a number has to be true.
@@ -0,0 +1,52 @@
1
+ <!-- Keep identical to the copy in the other creative skill (conductor-creative / conductor-content-studio references/layout-guide.md). Skills install independently and cannot reference each other. -->
2
+ # Layout guide
3
+
4
+ Pick the layout on purpose. A Creative has one layout across all its placements (9:16, 4:5, 1:1), so
5
+ choose it for the hardest placement, usually 9:16. Never rely on the registry default: it is
6
+ `stacked`, which is the wrong pick whenever 9:16 is enabled.
7
+
8
+ These notes come from rendering the same photo and headline in every layout with
9
+ `preview_creative_draft`.
10
+
11
+ ## Default
12
+
13
+ - 9:16 enabled: **`bleed`**. Use **`card`** when the photo itself must stay bright and readable.
14
+ - Only 4:5 and 1:1: `split` or `card` both work.
15
+
16
+ ## The layouts
17
+
18
+ - **`bleed`**: full-frame photo with a large headline. It is the only layout that fills 9:16 with a
19
+ big headline. Dark theme only (`theme: "light"` is refused). Its scrim darkens most of the photo on
20
+ 9:16 and 4:5, so choose a photo with a bright, high-contrast subject. On 4:5 the headline sits at
21
+ the top, so a face in the top third of the photo lands under it; on 1:1 the headline is small at the
22
+ bottom.
23
+ - **`card`**: the photo as a framed card with a large headline beneath. On 9:16 the bottom third is
24
+ an empty dark panel. Use it when the photo must stay readable, such as a product screen that
25
+ bleed's scrim would hide.
26
+ - **`split`**: good on 4:5, with a big headline under the photo. Bad on 9:16: the photo sits in the
27
+ top third, a large dark panel is left empty, the headline is small, and it failed the 9:16 bottom
28
+ safe-zone check. Don't use it when 9:16 is enabled.
29
+ - **`stacked`**: on 9:16 the photo band leaves an empty dark slab and the headline is forced small
30
+ (the 430 px bottom safe zone is solid fill). Don't use it when 9:16 is enabled. Fine for 4:5.
31
+
32
+ ## 1:1 headline size
33
+
34
+ On 1:1 every layout auto-fits the headline small (about 60 px at most). Pin it with `typeOverrides`,
35
+ e.g. `{"1x1": [88]}`; 92 passed the checks with an eight-word headline. A pinned size is not shrunk to
36
+ fit, so read `checks` again after pinning.
37
+
38
+ ## Logo
39
+
40
+ `lockup: "chip"` puts the logo on a white pill. Use it when the photo behind the logo is busy.
41
+
42
+ ## Photo and layout together
43
+
44
+ `focalOverride` (e.g. `{"4x5": "50% 80%"}`) only moves the subject when the crop leaves spare room:
45
+ a photo much taller than the placement's frame, or `card`'s wide strip on 1:1. A photo already close
46
+ to the placement's shape (a 4:5-ish photo on 4:5) has nothing to shift, and the override does nothing.
47
+ Check the next preview rather than assuming it worked.
48
+
49
+ If the subject's face would sit under the headline: try `focalOverride` where there is room, else pick
50
+ a photo with the subject lower in the frame, else use `card` (and pin `card`'s 1:1 crop with
51
+ `focalOverride` so the face isn't cut off). If two fix rounds still leave a weak frame, the photo is
52
+ usually the problem: say so and offer a different one.
@@ -0,0 +1,121 @@
1
+ <!-- Keep identical to the copy in the other creative skill (conductor-creative / conductor-content-studio references/slideshow-formats.md). Skills install independently and cannot reference each other. -->
2
+ # Slideshow formats
3
+
4
+ For organic posts: a native-looking photo slideshow (TikTok photo post, Instagram carousel) that
5
+ promotes an app or product by being worth watching first. Build it with `compose_slideshow`, then
6
+ post it as a CAROUSEL Creative. Ads use the brand layouts (STILL) instead; this is not the ad path.
7
+
8
+ Branding is light: no logo, badge or offer on the slides. The product appears as the payoff, not the
9
+ opener.
10
+
11
+ ## Post anatomy
12
+
13
+ Aim for 5 to 7 slides. Each slide has one job.
14
+
15
+ 1. **Slide 1, the hook.** A human tension or a result people want to keep. Never a feature, the
16
+ product name or a price.
17
+ 2. **Middle slides, the value.** The part people save or send: the list, the plan, the fix, the story
18
+ beat. Saves and sends carry a post beyond followers.
19
+ 3. **Slide N-1, the payoff.** The product in use on a real screenshot (a `screen` slide, optionally
20
+ with `callouts`) plus one plain mention, such as "I keep mine in <App>".
21
+ 4. **Last slide, the ask.** A save or follow ask: "Save this. Link in bio."
22
+
23
+ ## Slide types
24
+
25
+ Every slide takes `type` (default `photo`), an optional background (`bg` path, `bgColor`, `blur`,
26
+ `grade`, `grain`, `dim`) and `texts`. Each text is `{t, y, fs, style}`; the first text of a slide
27
+ needs `y`, and later texts without `y` stack under the previous one.
28
+
29
+ | Type | For | Key fields | Use when |
30
+ |---|---|---|---|
31
+ | `photo` | A full-bleed photo with text on it | `bg`, `pos`, `grade`, `grain`, `dim`, `texts` | The default hook, list or story slide |
32
+ | `screen` | A real app screenshot in a phone frame | `shot`, `phoneY`, `pw`, `cropH`, `callouts [{x, y, label}]`, `bg`, `blur`, `texts` | The payoff slide (N-1); callouts point at what to notice |
33
+ | `notes` | A Notes-app page | `title`, `date`, `items` (strings or `{t, done, strike}`), `paras` | A plan, checklist or "what I do now" |
34
+ | `messages` | A chat thread | `bubbles [{from: "me"|"them", t}]` | Doubt or conflict: what someone said to you |
35
+ | `grid` | A wall of small photos | `cols`, `gridTop`, `photos [{src, x, badge, cap, restore}]` | "Everything you saved and never used"; one tile `restore`d for the close |
36
+ | `stack` | Photos stacked in a column | `photos [{src, label}]` | A before/after with `label`s ("Before", "After") or a short comparison |
37
+ | `tier` | A tier list | `rows [{k, c, items}]`, `ts` | Ranking, "what's worth it and what isn't" |
38
+ | `week` | A week planner | `days [{d, t, img, icon, fog}]` | A routine or plan across days |
39
+ | `receipt` | A till receipt | `head`, `sections [{h, items}]`, `count` | A tally or breakdown; `count` must be a real figure |
40
+ | `placard` | A museum-style label over a photo | `bg`, `ex`, `title`, `y`, `lines [{k, v}]` | A deadpan, collectible-feeling item card |
41
+
42
+ Text `style`: `box` (white rounded box, TikTok's own text look), `dark` (dark box), `stroke` (white
43
+ text, black outline), `sub` (smaller subline).
44
+
45
+ ### Example spec
46
+
47
+ A five-slide "stop doing X" post. Paths are relative to the spec file or absolute.
48
+
49
+ ```json
50
+ {
51
+ "id": "stop-over-saving",
52
+ "slides": [
53
+ {"type": "photo", "bg": "photos/desk.jpg", "grade": true, "grain": true,
54
+ "texts": [{"t": "Stop saving things you will never open.", "y": 30, "fs": 76}]},
55
+ {"type": "messages",
56
+ "bubbles": [{"from": "them", "t": "did you ever look at that thing you saved?"},
57
+ {"from": "me", "t": "define look"}],
58
+ "texts": [{"t": "Be honest.", "y": 20}]},
59
+ {"type": "notes", "title": "What I do now", "date": "Today",
60
+ "items": ["Save one thing", {"t": "Open it within a day", "done": true}, "Delete the rest"]},
61
+ {"type": "screen", "shot": "shots/home.png", "phoneY": 40, "pw": 600,
62
+ "callouts": [{"x": 50, "y": 30, "label": "one tap"}],
63
+ "texts": [{"t": "I keep mine in <App>.", "y": 18}]},
64
+ {"type": "photo", "bg": "photos/desk.jpg", "dim": true,
65
+ "texts": [{"t": "Save this.", "y": 32, "fs": 80}, {"t": "Link in bio.", "style": "sub"}]}
66
+ ]
67
+ }
68
+ ```
69
+
70
+ ## Hook archetypes
71
+
72
+ Pick one per post and name it in the idea. Change one thing per post so results are comparable.
73
+
74
+ | Archetype | Slide 1 | Slides |
75
+ |---|---|---|
76
+ | Saved-but-never-used guilt | "Camera-roll graveyard." | `grid` (one tile `restore`d at the end), `photo`, `screen`, ask |
77
+ | Doubt or conflict | What someone said to you (needs a true story) | `messages`, `photo`, `notes`, `screen`, ask |
78
+ | Stop doing X | "Stop doing X." | `photo` with the reason per slide, `screen`, ask |
79
+ | Numbered list | "5 things worth saving" | `photo` per item, `screen` last, ask |
80
+ | Tier list | "Ranking everything I tried" | `tier`, `photo` close-ups, `screen`, ask |
81
+ | Notes-app plan | "My plan for the week" | `notes`, `week`, `screen`, ask |
82
+ | POV | "POV: you finally did it" | `photo` (hands or a real scene), `screen`, `photo`, ask |
83
+ | Before / after | "Week 1 vs week 4" | `stack` with `label`s, `photo`, `screen`, ask |
84
+
85
+ ## Text rules
86
+
87
+ - Native box text (`box`) or white text with a black stroke (`stroke`); centred, bold, sans.
88
+ - At most 8 words a line and 3 lines a box.
89
+ - Keep text between about y 16 and y 75 (percent of the 9:16 frame). That survives the 4:5 Instagram
90
+ cut and the platform UI (top bar, bottom caption, right button column).
91
+ - The first text of every slide needs `y`.
92
+ - Read the composer's `checks`; an `error` severity blocks the preview.
93
+
94
+ ## Honesty and brand
95
+
96
+ - No logo, badge or offer on the slides. The offer, if any, goes in the caption.
97
+ - No invented numbers or claims. A placeholder count (a receipt `count`, "312 saved") must be
98
+ replaced with a real figure, or the line rewritten without one.
99
+ - Real screenshots only for `screen` slides; never mock up the product.
100
+ - A generated photo needs the platform's AI label turned on. Turn on the platform's branded-content
101
+ or "your brand" setting for a brand's own promotional post.
102
+ - A conflict or testimonial story must be true, and anyone shown or quoted must be real and agree.
103
+
104
+ ## Getting the download
105
+
106
+ Captions on TikTok and Instagram cannot hold clickable links, so do not rely on one:
107
+
108
+ - Name the app in the caption and on slide N-1, so it can be searched ("search <App> in the App
109
+ Store").
110
+ - Pin a comment that says where to find it.
111
+ - Keep the link in the profile bio.
112
+ - Repost the post to Instagram Stories with a link sticker.
113
+
114
+ ## Flow
115
+
116
+ 1. Write the spec (`slideshow-spec.json`); call `compose_slideshow({specPath})`.
117
+ 2. If `passed` is false, fix every `error` check and compose again. Warnings are advisory.
118
+ 3. `preview_creative_draft({kind: "CAROUSEL", slidePaths, caption, slideAltText})` using the
119
+ returned `slidePaths` (`9x16` for TikTok, `4x5` for Instagram). Look at the contact sheet and show
120
+ it.
121
+ 4. Only after the person approves, `commit_creative_draft`.
@@ -39,7 +39,7 @@ pass `{mediaId}` as a `create_post` media item (or `upload_asset({issueId, media
39
39
  ### A publish pack, if one exists
40
40
 
41
41
  Some earlier steps hand over a publish pack with the content: per-destination copy and options, plus
42
- a first comment and notes. The content team (`conductor-content-studio`) writes one as
42
+ a pinned comment and notes. The content team (`conductor-content-studio`) writes one as
43
43
  `.conductor/content-runs/<run>/publish-pack.json` (and a readable `publish-pack.md`); any other
44
44
  producer can leave the same shape. When the content is a Creative, look for
45
45
  `.conductor/content-runs/*/publish-pack.json` whose `creativeId` matches it, or use the one the
@@ -54,7 +54,7 @@ person points to. If you find one:
54
54
  guess.
55
55
  - Show the pre-filled copy and options in the confirmation table (see Step 4) and let the person
56
56
  change any of them before anything is submitted. Their edit wins over the pack.
57
- - Mention the pack's first comment as a **manual step**: Conductor cannot post comments, so give the
57
+ - Mention the pack's pinned comment (and Stories repost, if listed) as a **manual step**: Conductor cannot post comments, so give the
58
58
  text to the person to paste once the post is live.
59
59
  - Pack or no pack, the normal review applies. The pack settles copy and options; it approves nothing.
60
60
 
@@ -840,6 +840,11 @@
840
840
  "prompt"
841
841
  ]
842
842
  },
843
+ {
844
+ "name": "compose_slideshow",
845
+ "description": "Compose native-looking organic slideshow slides (TikTok/Reels style) from a spec on this machine, with layout checks. Pass the PNG paths to preview_creative_draft as a CAROUSEL.",
846
+ "category": "marketing"
847
+ },
843
848
  {
844
849
  "name": "preview_creative_draft",
845
850
  "description": "Look at a Creative before anything is saved: renders a draft locally from the create_creative fields plus local files (photoPath, clipPath, audioPath) and returns the contact sheet as an image. Never writes to Conductor; commit only after the person approves.",
@@ -0,0 +1,93 @@
1
+ Copyright 2024 TikTok Inc. (https://github.com/tiktok/TikTokSans)
2
+
3
+ This Font Software is licensed under the SIL Open Font License, Version 1.1.
4
+ This license is copied below, and is also available with a FAQ at:
5
+ https://openfontlicense.org
6
+
7
+
8
+ -----------------------------------------------------------
9
+ SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
10
+ -----------------------------------------------------------
11
+
12
+ PREAMBLE
13
+ The goals of the Open Font License (OFL) are to stimulate worldwide
14
+ development of collaborative font projects, to support the font creation
15
+ efforts of academic and linguistic communities, and to provide a free and
16
+ open framework in which fonts may be shared and improved in partnership
17
+ with others.
18
+
19
+ The OFL allows the licensed fonts to be used, studied, modified and
20
+ redistributed freely as long as they are not sold by themselves. The
21
+ fonts, including any derivative works, can be bundled, embedded,
22
+ redistributed and/or sold with any software provided that any reserved
23
+ names are not used by derivative works. The fonts and derivatives,
24
+ however, cannot be released under any other type of license. The
25
+ requirement for fonts to remain under this license does not apply
26
+ to any document created using the fonts or their derivatives.
27
+
28
+ DEFINITIONS
29
+ "Font Software" refers to the set of files released by the Copyright
30
+ Holder(s) under this license and clearly marked as such. This may
31
+ include source files, build scripts and documentation.
32
+
33
+ "Reserved Font Name" refers to any names specified as such after the
34
+ copyright statement(s).
35
+
36
+ "Original Version" refers to the collection of Font Software components as
37
+ distributed by the Copyright Holder(s).
38
+
39
+ "Modified Version" refers to any derivative made by adding to, deleting,
40
+ or substituting -- in part or in whole -- any of the components of the
41
+ Original Version, by changing formats or by porting the Font Software to a
42
+ new environment.
43
+
44
+ "Author" refers to any designer, engineer, programmer, technical
45
+ writer or other person who contributed to the Font Software.
46
+
47
+ PERMISSION & CONDITIONS
48
+ Permission is hereby granted, free of charge, to any person obtaining
49
+ a copy of the Font Software, to use, study, copy, merge, embed, modify,
50
+ redistribute, and sell modified and unmodified copies of the Font
51
+ Software, subject to the following conditions:
52
+
53
+ 1) Neither the Font Software nor any of its individual components,
54
+ in Original or Modified Versions, may be sold by itself.
55
+
56
+ 2) Original or Modified Versions of the Font Software may be bundled,
57
+ redistributed and/or sold with any software, provided that each copy
58
+ contains the above copyright notice and this license. These can be
59
+ included either as stand-alone text files, human-readable headers or
60
+ in the appropriate machine-readable metadata fields within text or
61
+ binary files as long as those fields can be easily viewed by the user.
62
+
63
+ 3) No Modified Version of the Font Software may use the Reserved Font
64
+ Name(s) unless explicit written permission is granted by the corresponding
65
+ Copyright Holder. This restriction only applies to the primary font name as
66
+ presented to the users.
67
+
68
+ 4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
69
+ Software shall not be used to promote, endorse or advertise any
70
+ Modified Version, except to acknowledge the contribution(s) of the
71
+ Copyright Holder(s) and the Author(s) or with their explicit written
72
+ permission.
73
+
74
+ 5) The Font Software, modified or unmodified, in part or in whole,
75
+ must be distributed entirely under this license, and must not be
76
+ distributed under any other license. The requirement for fonts to
77
+ remain under this license does not apply to any document created
78
+ using the Font Software.
79
+
80
+ TERMINATION
81
+ This license becomes null and void if any of the above conditions are
82
+ not met.
83
+
84
+ DISCLAIMER
85
+ THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
86
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
87
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
88
+ OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
89
+ COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
90
+ INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
91
+ DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
92
+ FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
93
+ OTHER DEALINGS IN THE FONT SOFTWARE.
Binary file
Binary file
Binary file