@cliangdev/conductor 0.31.2 → 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.
- package/assets/claude/agents/conductor-content-art-director.md +23 -3
- package/assets/claude/agents/conductor-content-creative-director.md +6 -2
- package/assets/claude/agents/conductor-content-ideator.md +9 -3
- package/assets/claude/agents/conductor-content-scriptwriter.md +12 -4
- package/assets/claude/commands/conductor/content.md +3 -1
- package/assets/claude/commands/conductor/creative.md +10 -6
- package/assets/claude/skills/conductor-content-studio/SKILL.md +42 -15
- package/assets/claude/skills/conductor-content-studio/references/capabilities.md +8 -2
- package/assets/claude/skills/conductor-content-studio/references/design-critique.md +20 -1
- package/assets/claude/skills/conductor-content-studio/references/idea-template.md +3 -3
- package/assets/claude/skills/conductor-content-studio/references/publish-pack-template.md +8 -3
- package/assets/claude/skills/conductor-content-studio/references/rubric.md +5 -2
- package/assets/claude/skills/conductor-content-studio/references/slideshow-formats.md +121 -0
- package/assets/claude/skills/conductor-creative/SKILL.md +14 -1
- package/assets/claude/skills/conductor-creative/references/design-critique.md +20 -1
- package/assets/claude/skills/conductor-creative/references/slideshow-formats.md +121 -0
- package/assets/claude/skills/conductor-publisher/SKILL.md +2 -2
- package/assets/cli-manifest.json +5 -0
- package/assets/fonts/OFL.txt +93 -0
- package/assets/fonts/tiktok-sans-600.ttf +0 -0
- package/assets/fonts/tiktok-sans-700.ttf +0 -0
- package/assets/fonts/tiktok-sans-800.ttf +0 -0
- package/dist/lib/plugin-assets.d.ts.map +1 -1
- package/dist/lib/plugin-assets.js +2 -0
- package/dist/lib/plugin-assets.js.map +1 -1
- package/dist/lib/slideshow/compose.d.ts +37 -0
- package/dist/lib/slideshow/compose.d.ts.map +1 -0
- package/dist/lib/slideshow/compose.js +160 -0
- package/dist/lib/slideshow/compose.js.map +1 -0
- package/dist/lib/slideshow/css.d.ts +3 -0
- package/dist/lib/slideshow/css.d.ts.map +1 -0
- package/dist/lib/slideshow/css.js +103 -0
- package/dist/lib/slideshow/css.js.map +1 -0
- package/dist/lib/slideshow/html.d.ts +20 -0
- package/dist/lib/slideshow/html.d.ts.map +1 -0
- package/dist/lib/slideshow/html.js +192 -0
- package/dist/lib/slideshow/html.js.map +1 -0
- package/dist/lib/slideshow/index.d.ts +4 -0
- package/dist/lib/slideshow/index.d.ts.map +1 -0
- package/dist/lib/slideshow/index.js +4 -0
- package/dist/lib/slideshow/index.js.map +1 -0
- package/dist/lib/slideshow/spec.d.ts +109 -0
- package/dist/lib/slideshow/spec.d.ts.map +1 -0
- package/dist/lib/slideshow/spec.js +167 -0
- package/dist/lib/slideshow/spec.js.map +1 -0
- package/dist/mcp/index.d.ts +403 -0
- package/dist/mcp/index.d.ts.map +1 -1
- package/dist/mcp/index.js +21 -0
- package/dist/mcp/index.js.map +1 -1
- package/dist/mcp/tools/slideshow.d.ts +42 -0
- package/dist/mcp/tools/slideshow.d.ts.map +1 -0
- package/dist/mcp/tools/slideshow.js +77 -0
- package/dist/mcp/tools/slideshow.js.map +1 -0
- package/package.json +1 -1
|
@@ -14,8 +14,9 @@ send to the draft renderer, so it has to be valid on the first try.
|
|
|
14
14
|
|
|
15
15
|
- Read only the files you are given: `script.md`, `context/media.json`, `context/brand-kit.json`,
|
|
16
16
|
`references/shotlist-template.md`, `references/platform-specs.md`, `references/capabilities.md`,
|
|
17
|
-
`references/layout-guide.md`, `references/design-critique.md` and `references/publish-pack-template.md` when given.
|
|
18
|
-
- Write only your output files: `direction.md` and, for `RENDER`, `creative-spec.json
|
|
17
|
+
`references/layout-guide.md`, `references/design-critique.md`, `references/slideshow-formats.md` and `references/publish-pack-template.md` when given.
|
|
18
|
+
- Write only your output files: `direction.md` and, for `RENDER`, `creative-spec.json` (or
|
|
19
|
+
`slideshow-spec.json` for a slideshow), plus `image-prompts.json` when `media.json` has `generate: true`.
|
|
19
20
|
- Never call Conductor or any MCP tool.
|
|
20
21
|
|
|
21
22
|
## direction.md
|
|
@@ -38,7 +39,26 @@ licence (original audio, a Commercial Music Library track, a library track with
|
|
|
38
39
|
clip's own sound, or none). Never pick a trending track a business account cannot license. Alt
|
|
39
40
|
text also goes in the spec's `altText`. The orchestrator merges this section into `publish-pack.md`.
|
|
40
41
|
|
|
41
|
-
##
|
|
42
|
+
## slideshow-spec.json (a slideshow RENDER, instead of creative-spec.json)
|
|
43
|
+
|
|
44
|
+
Use this when the idea is an organic slideshow (the orchestrator tells you, and gives you
|
|
45
|
+
`references/slideshow-formats.md`; read it first). Write one JSON object, `{"id", "slides": [...]}`,
|
|
46
|
+
and nothing else; the orchestrator passes it to `compose_slideshow`. Rules:
|
|
47
|
+
|
|
48
|
+
- Follow the post anatomy: slide 1 a human tension, middle slides the value, slide N-1 the app on a
|
|
49
|
+
real screenshot (a `screen` slide, optionally with `callouts`) with one plain mention, the last slide
|
|
50
|
+
a save or follow ask. 5 to 7 slides. Choose each slide's `type` for its job from the table.
|
|
51
|
+
- Photos and the screenshot are paths from `media.json` or local files the person supplied; never
|
|
52
|
+
invent a path. Use a real screenshot only. If `generate: true`, write `image-prompts.json` for the
|
|
53
|
+
photo slots (`{"photo": "...", "beats": {"2": "<prompt for slide 2>"}}`, as below) and leave those
|
|
54
|
+
paths to the orchestrator.
|
|
55
|
+
- Text: at most 8 words a line and 3 lines a box, the first text of each slide has `y`, and every
|
|
56
|
+
text sits between y 16 and 75. No logo, badge or offer on any slide. No invented numbers.
|
|
57
|
+
- In `direction.md`, the Publish assets section still lists the cover frame (card 1), alt text for
|
|
58
|
+
every slide in order, and the sound. Alt text describes each slide for someone who cannot see it.
|
|
59
|
+
- Do not use `creative-spec.json` for it, and do not write layout, theme or headline fields.
|
|
60
|
+
|
|
61
|
+
## creative-spec.json (RENDER only; STILL and MOTION)
|
|
42
62
|
|
|
43
63
|
A single JSON object whose keys are exactly `preview_creative_draft` inputs, and nothing else:
|
|
44
64
|
|
|
@@ -36,8 +36,12 @@ Inputs: `brief.md`, `judging/scores.md`, `ideas/pool.md`, the finalist images un
|
|
|
36
36
|
Output: `decision.md`.
|
|
37
37
|
|
|
38
38
|
1. For each rendered finalist, look at its image and judge it as the rubric says (phone-size
|
|
39
|
-
readability, hook legibility in 1 s, safe zones, brand look) and score the
|
|
40
|
-
`references/design-critique.md` (1 to 5 each, absolute, one compact line per finalist)
|
|
39
|
+
readability, hook legibility in 1 s, safe zones, brand look) and score the craft criteria in
|
|
40
|
+
`references/design-critique.md` (1 to 5 each, absolute, one compact line per finalist): the six
|
|
41
|
+
STILL criteria for a still, ad or motion piece, the five slideshow criteria (slide 1 stops the
|
|
42
|
+
scroll, each slide earns the next swipe, people would save or send it, the app shows up as the
|
|
43
|
+
payoff not the opener, native look) for a slideshow. Never score a slideshow on the STILL set, which
|
|
44
|
+
rewards product and logo prominence an organic post should not have. Note
|
|
41
45
|
anything the text round could not see. A generated photo that reads as AI-made (waxy surfaces, duplicated or merged objects,
|
|
42
46
|
warped hands, mushy background; see `references/realism-check.md`) counts against that finalist:
|
|
43
47
|
say so explicitly.
|
|
@@ -38,11 +38,17 @@ ideas from your angle, not a safe average.
|
|
|
38
38
|
social-proof).
|
|
39
39
|
5. Tag each idea `RENDER` or `FILM` honestly, using `references/capabilities.md` and `media.json`.
|
|
40
40
|
It is `RENDER` only if every card or frame fits what Conductor can render with media that exists:
|
|
41
|
-
one photo plus text per card,
|
|
42
|
-
|
|
41
|
+
one photo plus text per card, a native slideshow (photos, app screenshots, Notes pages, chats, tier
|
|
42
|
+
lists and similar slides), or motion text over a photo or clip. That covers motion text, which
|
|
43
|
+
needs no filming. There are no type-only stills, voiceover or screen recordings.
|
|
43
44
|
Footage, a person on camera or spoken lines make it `FILM`. For `RENDER`, fill the draft-spec
|
|
44
45
|
block, use only media ids that exist, and respect the copy rules and accent-phrase requirement.
|
|
45
|
-
6.
|
|
46
|
+
6. For an organic post, a `RENDER` idea is usually a slideshow. Name its archetype (saved-but-never-used
|
|
47
|
+
guilt, doubt or conflict, stop doing X, numbered list, tier list, Notes-app plan, POV, before/after;
|
|
48
|
+
see `references/slideshow-formats.md` when given) and the slide count (5 to 7), and put the slide 1
|
|
49
|
+
hook in the on-screen hook. Slide 1 is a human tension, never a feature, the app name or a price.
|
|
50
|
+
Put these in the Concept line; the draft spec may then be "slideshow, <archetype>, <n> slides".
|
|
51
|
+
7. Do not name your angle inside an idea. Do not rank your ideas.
|
|
46
52
|
|
|
47
53
|
## Finish
|
|
48
54
|
|
|
@@ -31,15 +31,23 @@ anything.
|
|
|
31
31
|
against the copy rules and write the result in the final section.
|
|
32
32
|
5. Keep captions within each platform's limits as given in `platform-specs.md`; include only the
|
|
33
33
|
platforms the brief asks for. In the **Publish copy** section also write, per platform: the
|
|
34
|
-
caption with the search keyword in its opening words (and in the on-screen text and speech)
|
|
35
|
-
|
|
34
|
+
caption with the search keyword in its opening words (and in the on-screen text and speech) and a
|
|
35
|
+
call to action that names the app so it can be searched ("search <App> in the App Store"; a
|
|
36
|
+
caption cannot hold a clickable link), 3 to 5 hashtags, a pinned-comment line (where to get it,
|
|
37
|
+
"link in bio"), and a reminder to repost to Instagram Stories with a link sticker. Note the
|
|
38
|
+
branded-content or "your brand" setting the post needs. Then write 2 or 3 alternate hooks,
|
|
36
39
|
each tagged with a hookType (question, bold-claim, pattern-interrupt, relatable-pain, how-to,
|
|
37
40
|
number, curiosity-gap, story, social-proof) that differs from the main hook's type. The
|
|
38
41
|
orchestrator merges this section into `publish-pack.md`. Every factual claim must be one the
|
|
39
42
|
brief, knowledge or approved lines confirm; soften or drop any other.
|
|
40
|
-
6. For a
|
|
43
|
+
6. For a slideshow, the script is slide by slide: slide 1 the human tension, middle slides the value,
|
|
44
|
+
slide N-1 the app on a real screenshot with one plain mention ("I keep mine in <App>"), the last
|
|
45
|
+
slide a save or follow ask. At most 8 words a line and 3 lines a box. No logo, badge or offer on a
|
|
46
|
+
slide; the offer goes in the caption. Invent no numbers: a count must come from the brief or
|
|
47
|
+
knowledge, or be left out.
|
|
48
|
+
7. For a `FILM` idea, write for a person on camera: spoken lines in natural speech, with the
|
|
41
49
|
on-screen text separate. For a `RENDER` idea, keep the text short enough to read at phone size.
|
|
42
|
-
|
|
50
|
+
8. When the orchestrator passes user change requests, apply them and keep everything else.
|
|
43
51
|
|
|
44
52
|
## Finish
|
|
45
53
|
|
|
@@ -11,7 +11,9 @@ One command from "I need a post for X" to a committed Creative (or, for an idea
|
|
|
11
11
|
a shoot-ready script). The team chooses the idea itself; the only point where it stops for you is the
|
|
12
12
|
final draft preview. This command gathers the request and hands off to the `conductor-content-studio`
|
|
13
13
|
skill (`Skill(skill: "conductor-content-studio")`), which runs the stages. Don't re-derive what that
|
|
14
|
-
skill covers.
|
|
14
|
+
skill covers. For an organic post the team's renderable ideas are native slideshows (built with
|
|
15
|
+
`compose_slideshow`, posted as a CAROUSEL Creative); stills and motion pieces stay for ideas that
|
|
16
|
+
are one image, an ad, or a motion piece.
|
|
15
17
|
|
|
16
18
|
## Trigger
|
|
17
19
|
|
|
@@ -6,8 +6,8 @@ allowed-tools: mcp__conductor__*, AskUserQuestion, Skill, WebFetch, Read, Glob,
|
|
|
6
6
|
|
|
7
7
|
# /conductor:creative
|
|
8
8
|
|
|
9
|
-
Guided entry point for making a Post's artwork — a static ad, a short video,
|
|
10
|
-
already on hand. Keeps the interaction short: a couple of questions, then it hands off to the
|
|
9
|
+
Guided entry point for making a Post's artwork — a static ad, a short video, an organic slideshow,
|
|
10
|
+
or posting a video already on hand. Keeps the interaction short: a couple of questions, then it hands off to the
|
|
11
11
|
`conductor-creative` skill (`Skill(skill: "conductor-creative")`) for the actual writing, rendering
|
|
12
12
|
and judgment calls. This command doesn't replace that skill's guidance — read it once invoked and
|
|
13
13
|
follow it.
|
|
@@ -31,7 +31,7 @@ continue with Step 2.
|
|
|
31
31
|
"question": "What would you like to create?",
|
|
32
32
|
"header": "Creative Type",
|
|
33
33
|
"options": [
|
|
34
|
-
{"label": "Static ad", "description": "A photo + headline,
|
|
34
|
+
{"label": "Static ad", "description": "A photo + headline ad with the brand layout, at every enabled placement (not for organic posts)"},
|
|
35
35
|
{"label": "Short video from a photo", "description": "Animated text over a still photo or a moving background"},
|
|
36
36
|
{"label": "Video from a clip I have", "description": "Animate the brand layout using an existing video as background"},
|
|
37
37
|
{"label": "Post an existing video as-is", "description": "No brand layout — the finished clip goes up directly"},
|
|
@@ -51,6 +51,10 @@ Keep this light — one or two follow-up questions, not a form:
|
|
|
51
51
|
already on hand before asking for a new photo; no photo fits and none is offered? Offer to generate one with
|
|
52
52
|
`generate_creative_image` (needs an OpenAI API key, or the person's yes to use Codex). A new photo is a local file path (a URL: download it
|
|
53
53
|
to a local file first) — it is only uploaded after the person approves the preview.
|
|
54
|
+
- **Organic post or slideshow** (the person says so under "Other", or describes a TikTok or Instagram
|
|
55
|
+
photo post that is not an ad): skip the brand layouts. Hand off to the `conductor-creative` skill's
|
|
56
|
+
slideshow path (`references/slideshow-formats.md`): `compose_slideshow`, then a CAROUSEL preview,
|
|
57
|
+
approval and commit. Ask for the topic, the photos and a real app screenshot, if there is one.
|
|
54
58
|
- **Video from a clip I have / Post an existing video as-is**: call
|
|
55
59
|
`list_creative_media({kind: "VIDEO"})` first; if nothing fits, ask for a local path (a URL:
|
|
56
60
|
download it first). A clip used as a MOTION background is previewed from the local file too.
|
|
@@ -94,8 +98,8 @@ Nothing is saved to Conductor until the person approves what they have seen:
|
|
|
94
98
|
|
|
95
99
|
When the Creative came from a content-team run, or the person points to a publish pack, its
|
|
96
100
|
`publish-pack.json` carries per-destination captions and publish options (disclosure, AI label,
|
|
97
|
-
cover frame, alt text) and a
|
|
101
|
+
cover frame, alt text) and a pinned comment. Look for `.conductor/content-runs/*/publish-pack.json`
|
|
98
102
|
whose `creativeId` matches the Creative. When you go on to create or edit the Post with the
|
|
99
103
|
`conductor-publisher` skill, pre-fill each target's `captionOverride` and options from it, show them
|
|
100
|
-
in the confirmation table and let the person change them. Mention the
|
|
101
|
-
|
|
104
|
+
in the confirmation table and let the person change them. Mention the pinned comment (and, for a post that promotes an app, the Stories repost with a link sticker) as manual
|
|
105
|
+
steps, since Conductor cannot post comments. The Post still goes through the normal review.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: conductor-content-studio
|
|
3
|
-
description: Runs a small team of subagents (strategist, three ideators, creative director, scriptwriter, art director) that brainstorm competing short-form social post ideas, pick one with a bias-resistant judging method, write the script and visual direction, run pre-publish checks (disclosure, AI label, music, claims, third-party material, accessibility), and render a local draft with a publish pack the publisher later pre-fills from. The person approves at the preview; only then is the Creative uploaded to Conductor. Ideas are either RENDER (a still, carousel, story sequence or motion text that Conductor can render) or FILM (needs real filming, so the output is a shoot-ready script). A run ends at a committed Creative or a shoot script and never creates a Post. Use when asked to come up with, choose and make a short-form post (TikTok, Reels, Shorts, Facebook) from a goal rather than from a given headline, or via /conductor:content. For a headline or photo already chosen, use conductor-creative instead.
|
|
3
|
+
description: Runs a small team of subagents (strategist, three ideators, creative director, scriptwriter, art director) that brainstorm competing short-form social post ideas, pick one with a bias-resistant judging method, write the script and visual direction, run pre-publish checks (disclosure, AI label, music, claims, third-party material, accessibility), and render a local draft with a publish pack the publisher later pre-fills from. The person approves at the preview; only then is the Creative uploaded to Conductor. Ideas are either RENDER (a native slideshow for organic posts, or a still, carousel, story sequence or motion text that Conductor can render) or FILM (needs real filming, so the output is a shoot-ready script). A run ends at a committed Creative or a shoot script and never creates a Post. Use when asked to come up with, choose and make a short-form post (TikTok, Reels, Shorts, Facebook) from a goal rather than from a given headline, or via /conductor:content. For a headline or photo already chosen, use conductor-creative instead.
|
|
4
4
|
user-invocable: true
|
|
5
5
|
allowed-tools: mcp__conductor__*, Agent, AskUserQuestion, Skill, Read, Write, Glob, Grep, WebFetch
|
|
6
6
|
---
|
|
@@ -30,6 +30,10 @@ Each exists because of a known failure mode (sources are in `references/rubric.m
|
|
|
30
30
|
- **One gate.** The person is asked only at the final draft preview. Do not stop to ask which idea.
|
|
31
31
|
The one exception is S5b's disclosure question, asked only when disclosure cannot be inferred.
|
|
32
32
|
- **A run never creates a Post.** It ends at a committed Creative (or a shoot script).
|
|
33
|
+
- **Organic posts default to a slideshow.** A `RENDER` idea for an organic post (not an ad) is a
|
|
34
|
+
native-looking slideshow built by `compose_slideshow` and posted as a CAROUSEL; see
|
|
35
|
+
`references/slideshow-formats.md`. STILL and MOTION stay for ideas that really are one still, an
|
|
36
|
+
ad, or a motion piece. A slideshow never carries a logo, badge or offer.
|
|
33
37
|
|
|
34
38
|
Cost: a run is about 8 subagent calls (strategist 1, ideators 3, director 2, scriptwriter 1, art
|
|
35
39
|
director 1), and only the strategist and the director use the top model tier. `--quick` runs two
|
|
@@ -44,6 +48,7 @@ folder; give subagents absolute paths.
|
|
|
44
48
|
|
|
45
49
|
```
|
|
46
50
|
request.md run.json brief.md script.md direction.md creative-spec.json decision.md
|
|
51
|
+
slideshow-spec.json (S5, instead of creative-spec.json, when the winner is a slideshow)
|
|
47
52
|
image-prompts.json (S5, only when generation is enabled)
|
|
48
53
|
context/ brand-kit.json knowledge.md performance.md learning.md media.json
|
|
49
54
|
ideas/ angle-1.md angle-2.md angle-3.md pool.md winner.md
|
|
@@ -122,7 +127,8 @@ Write `request.md` (the request verbatim, `--quick` if given, the platform if st
|
|
|
122
127
|
not, using views, engagement rate, average view percentage, 72 h views and any 3-second or
|
|
123
128
|
completion figure the insights expose, and any experiment result. Name what you could not
|
|
124
129
|
measure. With no earlier run or no data, write exactly "No data yet".
|
|
125
|
-
6. Every renderable idea needs a photo (or, for MOTION, a clip
|
|
130
|
+
6. Every renderable idea needs a photo (or, for MOTION, a clip; for a slideshow's payoff slide, a real
|
|
131
|
+
app screenshot, so ask for one if the media has none); see `references/capabilities.md`. If
|
|
126
132
|
`media.json` has no unblocked image and no clip, ask once with `AskUserQuestion` before ideating:
|
|
127
133
|
**Give a photo or two** (local paths; record them in `context/media.json` as `local` entries the
|
|
128
134
|
art director may use via `photoPath`), **Generate a photo** (record `"generate": true` in
|
|
@@ -175,7 +181,10 @@ before each score, and names the top 3. Store the finalists in `run.json`.
|
|
|
175
181
|
|
|
176
182
|
### S3b — Finalist drafts (you; skipped in `--quick`)
|
|
177
183
|
|
|
178
|
-
|
|
184
|
+
A slideshow finalist has no cheap draft: judge it from its idea text (archetype and slide-by-slide
|
|
185
|
+
text) unless its slides can be composed from photos already on hand. In that case write its spec to
|
|
186
|
+
`<run>/drafts/finalist-<id>/slideshow-spec.json`, call `compose_slideshow` with `draftDir` set to
|
|
187
|
+
that folder and judge from the first slide and the `checks`. For every other `RENDER` finalist, call `preview_creative_draft` with that idea's draft spec (map the
|
|
179
188
|
draft-spec block to the tool's fields) and `draftDir` set to `<run>/drafts/finalist-<id>`. Use
|
|
180
189
|
`full: false`. Record each draft dir in `run.json`. For a finalist whose draft spec carries an
|
|
181
190
|
`imagePrompt`, call `generate_creative_image({prompt})` first, run the realism check
|
|
@@ -212,13 +221,22 @@ which idea to take; show the decision at the gate.
|
|
|
212
221
|
First copy the winning idea's block from `ideas/pool.md` to `ideas/winner.md`. Then
|
|
213
222
|
`Agent(subagent_type: "conductor-content-scriptwriter")` with `brief.md`, `decision.md`, `ideas/winner.md`, `references/script-template.md`, `references/platform-specs.md` and
|
|
214
223
|
`references/publish-pack-template.md`. Besides the script it writes the Publish copy section: a
|
|
215
|
-
caption per platform
|
|
224
|
+
caption per platform whose call to action names the app so it can be searched, hashtags, a pinned
|
|
225
|
+
comment and 2 to 3 alternate hooks with a hookType each.
|
|
216
226
|
For a `MOTION` winner tell it that the render shows one headline and one optional body, animated
|
|
217
227
|
by preset, then an end card that holds the final frame: no timed multi-beat on-screen text. Extra
|
|
218
228
|
beats belong in a story or carousel sequence, or in the caption. When merging into `publish-pack.json`, append each platform's hashtags to its `captionOverride`
|
|
219
229
|
(caption, blank line, hashtags): that field is posted verbatim.
|
|
220
230
|
|
|
221
|
-
### S5 — Art director (`RENDER` only) -> `direction.md` + `creative-spec.json`
|
|
231
|
+
### S5 — Art director (`RENDER` only) -> `direction.md` + `creative-spec.json` or `slideshow-spec.json`
|
|
232
|
+
|
|
233
|
+
For a slideshow winner the art director writes `slideshow-spec.json` instead of `creative-spec.json`
|
|
234
|
+
(and no `image-prompts.json` unless it needs a photo made). Give it `references/slideshow-formats.md`,
|
|
235
|
+
`context/media.json`, `script.md`, `references/platform-specs.md`, `references/design-critique.md` and
|
|
236
|
+
`references/publish-pack-template.md`. Photos and the app screenshot are paths from `media.json`
|
|
237
|
+
(download a library image to a local file first) or the person's local files; generated photos go
|
|
238
|
+
through `generate_creative_image` and the realism check first, as below. The rest of this stage is
|
|
239
|
+
the STILL/MOTION path.
|
|
222
240
|
|
|
223
241
|
`Agent(subagent_type: "conductor-content-art-director")` with `script.md`, `context/media.json`,
|
|
224
242
|
`context/brand-kit.json`, `references/shotlist-template.md`, `references/platform-specs.md` and
|
|
@@ -236,7 +254,7 @@ idea's title only: never include the internal `I<n>` ID, which means nothing out
|
|
|
236
254
|
(`{"photo": "...", "beats": {"2": "..."}}`) next to the spec. Before S6, call
|
|
237
255
|
`generate_creative_image` for each prompt, run the realism check (`references/realism-check.md`,
|
|
238
256
|
regenerating on a fail) on each image, and set `photoPath` (or
|
|
239
|
-
`sequence[i].photoPath`) in `creative-spec.json
|
|
257
|
+
`sequence[i].photoPath`) in `creative-spec.json` (for a slideshow, the slide's `bg` or `photos[].src` in `slideshow-spec.json`; `beats` keys are slide numbers). A `FILM` winner skips S5 and goes to the shoot
|
|
240
258
|
script, below.
|
|
241
259
|
|
|
242
260
|
### S5b — Publish pack and pre-publish checks (you; RENDER after S5, FILM after the shoot script)
|
|
@@ -245,7 +263,7 @@ Before the gate, so the person sees the settings with the draft. Skip nothing he
|
|
|
245
263
|
does not apply is answered "not applicable".
|
|
246
264
|
|
|
247
265
|
1. Run `references/compliance-checklist.md` against `brief.md`, `script.md`, `direction.md` (or the
|
|
248
|
-
shoot script), `creative-spec.json` and the provenance in `context/media.json` (`aiGenerated`,
|
|
266
|
+
shoot script), `creative-spec.json` (or `slideshow-spec.json`) and the provenance in `context/media.json` (`aiGenerated`,
|
|
249
267
|
`licence`).
|
|
250
268
|
2. Merge the scriptwriter's Publish copy and the art director's Publish assets, add the compliance
|
|
251
269
|
results, and write `publish-pack.md` and `publish-pack.json` in the shapes of
|
|
@@ -269,11 +287,18 @@ does not apply is answered "not applicable".
|
|
|
269
287
|
`draftDir` (the default location is cleaned up automatically after the commit). Record the
|
|
270
288
|
returned `draftDir` as `drafts.final`. Local files (`photoPath`, `clipPath`, `audioPath`) go in
|
|
271
289
|
as given in the spec.
|
|
290
|
+
**Slideshow winner:** `compose_slideshow({specPath})` on `slideshow-spec.json`; while `passed` is
|
|
291
|
+
false, fix the spec and compose again. Then `preview_creative_draft({kind: "CAROUSEL", slidePaths,
|
|
292
|
+
caption, slideAltText})` with the returned `slidePaths` (`9x16` for TikTok, `4x5` for Instagram),
|
|
293
|
+
the caption from `publish-pack.json` and the alt text from `direction.md`. Record the preview's
|
|
294
|
+
`draftDir` as `drafts.final`.
|
|
272
295
|
2. Eye-check the image. Load the `conductor-creative` skill with `Skill(skill: "conductor-creative")` and
|
|
273
296
|
apply its review guidance (step 7 and the silent-failures list), scoring the draft with
|
|
274
|
-
`references/design-critique.md` (
|
|
297
|
+
`references/design-critique.md` (the slideshow criteria for a slideshow, the STILL criteria
|
|
298
|
+
otherwise; any criterion below 3 is fixed before anyone sees it). For a STILL: does the headline read at a
|
|
275
299
|
glance, does the accent phrase fall on the words that carry the meaning, is copy on a face, are
|
|
276
|
-
the safe zones clear.
|
|
300
|
+
the safe zones clear. For a slideshow: does slide 1 stop the scroll, is the text inside y 16 to 75,
|
|
301
|
+
is the screenshot real, and is there no logo, badge or offer. Also read the result's `checks`/`passed`: while any blocking check fails,
|
|
277
302
|
fix it (`layoutOverrides` for photo height, `typeOverrides` for text size, a shorter body) and
|
|
278
303
|
re-preview **before** showing anything, and never offer Approve & upload while one still fails.
|
|
279
304
|
Revise at most twice beyond that; if it is still wrong, show it honestly and say what is off.
|
|
@@ -281,12 +306,13 @@ does not apply is answered "not applicable".
|
|
|
281
306
|
`drafts/finalist-<id>/sheet.jpg`; say when a runner-up could not be rendered; with `--quick` no
|
|
282
307
|
sheets exist, so show runners-up by title and tag only), and a short decision
|
|
283
308
|
summary (the winner and why, the runners-up, what was cut and why), and a short pack summary: the
|
|
284
|
-
disclosure setting (which toggle, or none), the AI-label setting, the sound and its licence,
|
|
285
|
-
the alternate hooks with their types. For each generated photo, add its one-line realism verdict.
|
|
309
|
+
disclosure setting (which toggle, or none), the AI-label setting, the sound and its licence, the
|
|
310
|
+
pinned comment and the Stories link-sticker repost, and the alternate hooks with their types. For each generated photo, add its one-line realism verdict.
|
|
286
311
|
4. Ask with `AskUserQuestion`, header "Draft", with exactly these four options. `AskUserQuestion`
|
|
287
312
|
allows at most four, so never add one per runner-up, and **Stop** must always be among them:
|
|
288
313
|
- **Approve & upload**: the question says approving also confirms the photo carries no burned-in
|
|
289
|
-
text, logo or claim
|
|
314
|
+
text, logo or claim (for a slideshow: every number and claim on the slides is real and the
|
|
315
|
+
screenshot is genuine). Ask for provenance (`source`, `licence`, and whether it is AI-generated)
|
|
290
316
|
only for local files the preview lists in `provenance.needed` (a file from
|
|
291
317
|
`generate_creative_image` already carries it), then
|
|
292
318
|
`commit_creative_draft({draftDir, photoChecked: true, source, licence, aiGenerated})` (provenance
|
|
@@ -312,7 +338,7 @@ does not apply is answered "not applicable".
|
|
|
312
338
|
and `references/shotlist-template.md`, output `shoot/shoot-script.md`: script, shot list, capture
|
|
313
339
|
settings (9:16, 30 fps, sound on), B-roll, safe zones, and the on-screen text and captions ready to
|
|
314
340
|
paste. It also writes the Publish assets section there. It writes no `creative-spec.json` here.
|
|
315
|
-
2. Run S5b. The shoot script gets the publish pack too (captions, hashtags,
|
|
341
|
+
2. Run S5b. The shoot script gets the publish pack too (captions, hashtags, pinned comment,
|
|
316
342
|
disclosure, music and its licence) so it can be applied when the clip is posted later; append a
|
|
317
343
|
short "Publish pack" section to `shoot/shoot-script.md`, and leave `creativeId` null in
|
|
318
344
|
`publish-pack.json`.
|
|
@@ -327,9 +353,9 @@ Keep it short:
|
|
|
327
353
|
|
|
328
354
|
- the decision summary: winner, one line on why, the runners-up;
|
|
329
355
|
- the Creative display id (and the readiness gaps, if any) or the shoot doc path;
|
|
330
|
-
- `publish-pack.md` (captions, hashtags,
|
|
356
|
+
- `publish-pack.md` (captions, hashtags, pinned comment, disclosure and AI-label settings, sound,
|
|
331
357
|
alternate hooks); say the publisher will pre-fill the Post from `publish-pack.json`, and that the
|
|
332
|
-
|
|
358
|
+
pinned comment, the link in bio and the Stories repost with a link sticker are manual steps;
|
|
333
359
|
- next steps:
|
|
334
360
|
- make the Post with `/conductor:creative` or the `conductor-publisher` skill (the Creative is
|
|
335
361
|
not on a Post yet, because a run never creates one);
|
|
@@ -350,4 +376,5 @@ Keep it short:
|
|
|
350
376
|
## Related
|
|
351
377
|
|
|
352
378
|
- `conductor-creative`: the single-Creative skill whose checklist S6 uses.
|
|
379
|
+
- `references/slideshow-formats.md`: the slideshow spec, archetypes and text rules.
|
|
353
380
|
- `conductor-publisher`: takes the committed Creative onto a Post, pre-filled from `publish-pack.json`.
|
|
@@ -27,6 +27,12 @@ needs changing until it fits.
|
|
|
27
27
|
(`slides`, with `default` as the fallback) and each must match its placement's aspect. Reels,
|
|
28
28
|
Stories and YouTube cannot take it.
|
|
29
29
|
|
|
30
|
+
- **Slideshow** (organic posts): native-looking slides made locally by `compose_slideshow` (photo with
|
|
31
|
+
text, app screenshot with callouts, Notes page, chat, photo grid, stacked before/after, tier list,
|
|
32
|
+
week planner, receipt, placard), then posted as a CAROUSEL (see `references/slideshow-formats.md`).
|
|
33
|
+
This is the default for an organic `RENDER` post. It needs real photos and, for the payoff slide,
|
|
34
|
+
a real app screenshot; it takes no Brand Kit layout. Ads keep using STILL.
|
|
35
|
+
|
|
30
36
|
## Hard requirements (a draft is refused without them)
|
|
31
37
|
|
|
32
38
|
- **A photo.** Every STILL needs one, and so does a carousel or story, whose beats inherit the main
|
|
@@ -71,7 +77,7 @@ Ask for a mid-tone scene: under `bleed`, a dark or night scene can render almost
|
|
|
71
77
|
|
|
72
78
|
- Footage of people, places, cooking or the product in use. Screen recordings of an app.
|
|
73
79
|
- Voiceover or spoken dialogue: MOTION has music or clip sound, not speech.
|
|
74
|
-
-
|
|
75
|
-
|
|
80
|
+
- Charts, illustrations, or text inside a generated image. In a STILL each card is one photo plus
|
|
81
|
+
text; grids, stacks and collages exist only as slideshow slides (above).
|
|
76
82
|
- Anything that relies on a product claim the brief can't confirm. That's a copy problem, not a
|
|
77
83
|
rendering one: soften the claim or drop the idea.
|
|
@@ -7,7 +7,13 @@ and fonts. This critique covers craft, and it runs before the person sees a draf
|
|
|
7
7
|
Look at the preview image at phone size. Vision models miss small typography details, so don't
|
|
8
8
|
claim to have judged kerning or hairline spacing; judge what is visible at a glance.
|
|
9
9
|
|
|
10
|
-
##
|
|
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)
|
|
11
17
|
|
|
12
18
|
Score each one on its own, against the description, not against another draft.
|
|
13
19
|
|
|
@@ -31,3 +37,16 @@ Score each one on its own, against the description, not against another draft.
|
|
|
31
37
|
|
|
32
38
|
One compact line next to the preview, for example:
|
|
33
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.`
|
|
@@ -13,7 +13,7 @@ Heading: `## Idea <n>: <title>` where the title is 8 words or fewer.
|
|
|
13
13
|
- **Hook, spoken:** <max 12 words, or "none (text only)">
|
|
14
14
|
- **Hook, on screen:** <max 12 words>
|
|
15
15
|
- **Hook type:** <question | bold-claim | pattern-interrupt | relatable-pain | how-to | number | curiosity-gap | story | social-proof>
|
|
16
|
-
- **Format:** <still | carousel | story sequence | motion text over photo | motion text over clip | talking head | demo | skit | other>
|
|
16
|
+
- **Format:** <slideshow | still | carousel | story sequence | motion text over photo | motion text over clip | talking head | demo | skit | other>
|
|
17
17
|
- **Platform:** <primary platform, then any others>
|
|
18
18
|
- **Tag:** RENDER | FILM
|
|
19
19
|
- **Why this audience cares:** <max 30 words, tied to the brief's tension>
|
|
@@ -21,7 +21,7 @@ Heading: `## Idea <n>: <title>` where the title is 8 words or fewer.
|
|
|
21
21
|
|
|
22
22
|
Draft spec (RENDER only):
|
|
23
23
|
|
|
24
|
-
- kind: STILL | MOTION
|
|
24
|
+
- kind: STILL | MOTION | slideshow (organic post: name the archetype and slide count, 5 to 7, instead of the fields below)
|
|
25
25
|
- layout: <a layout the brand kit and registry support>
|
|
26
26
|
- theme: dark | light
|
|
27
27
|
- headline: <with exactly one *accent phrase* if the kit requires it>
|
|
@@ -33,7 +33,7 @@ Draft spec (RENDER only):
|
|
|
33
33
|
- motion: <MOTION only: preset, durationSec, background>
|
|
34
34
|
```
|
|
35
35
|
|
|
36
|
-
The idea's format maps to the publish pack's `tags.format` as: still -> `still`; carousel ->
|
|
36
|
+
The idea's format maps to the publish pack's `tags.format` as: slideshow -> `carousel`; still -> `still`; carousel ->
|
|
37
37
|
`carousel`; story sequence -> `story`; motion text over photo or clip -> `motion`; talking head,
|
|
38
38
|
demo, skit or other -> `film`.
|
|
39
39
|
|
|
@@ -28,9 +28,14 @@ Run: <runId> Creative: <display id, or "not yet committed"> Tags: hook <type
|
|
|
28
28
|
|
|
29
29
|
## <Platform> (<feed | reel | story>, as the destination's formats allow)
|
|
30
30
|
- **Caption:** <final text; the search keyword is in the first line, within the first ~125
|
|
31
|
-
characters;
|
|
31
|
+
characters; the call to action names the app so it is searchable ("search <App> in the App
|
|
32
|
+
Store"), because captions hold no clickable link; within the platform's limit>
|
|
32
33
|
- **Hashtags:** <3 to 5>
|
|
33
|
-
- **
|
|
34
|
+
- **Pinned comment (post manually):** <text, such as where to get the app, or "none">. Conductor cannot post comments.
|
|
35
|
+
- **Link in bio / Stories:** <"link in bio is set" and, for a post that promotes an app or offer,
|
|
36
|
+
"repost to Instagram Stories with a link sticker">. Manual steps.
|
|
37
|
+
- **Branded-content setting:** <the platform's branded-content or "your brand" toggle for a brand's
|
|
38
|
+
own promotional post, and the AI label when a generated photo is used>
|
|
34
39
|
- **Cover frame:** <video: timestamp in seconds and what is on it; carousel: card 1; still: n/a>
|
|
35
40
|
- **Alt text:** <one line per image or card, in order>
|
|
36
41
|
- **On-screen text placement:** <where each line sits, inside the safe zone>
|
|
@@ -94,7 +99,7 @@ Rules:
|
|
|
94
99
|
`list_publish_targets`. `captionOverride` is ignored on a story.
|
|
95
100
|
- `captionOverride` is the **complete text that gets posted**: the caption, then a blank line, then that
|
|
96
101
|
platform's hashtags. The publisher posts it as-is, so hashtags listed only in `publish-pack.md` never
|
|
97
|
-
reach the platform. The
|
|
102
|
+
reach the platform. The pinned comment is the one thing that stays out: it is posted by hand.
|
|
98
103
|
- `options` holds real option keys only, in the camelCase the destination reports under
|
|
99
104
|
`optionKeys`. Never add a key that is not in this table, and never `privacyLevel` (the person
|
|
100
105
|
picks it from the account's allowed levels at publish time):
|
|
@@ -58,8 +58,11 @@ Look at the actual image file, not the text description. Check:
|
|
|
58
58
|
- Hook legibility in 1 second: is the first thing seen the hook, in high contrast?
|
|
59
59
|
- Safe zones: text out of the platform UI (see `platform-specs.md`), nothing sitting on a face.
|
|
60
60
|
- Brand look: tokens, font, logo lockup, accent phrase on the words that carry the meaning.
|
|
61
|
-
- Craft: score the
|
|
62
|
-
|
|
61
|
+
- Craft: score the criteria in `design-critique.md`. For a still, ad or brand-layout creative, the
|
|
62
|
+
six STILL criteria (thumb-stop, headline size and position, empty space, photo and copy together,
|
|
63
|
+
product shown, not a banner ad). For a slideshow, the five slideshow criteria (slide 1 stops the
|
|
64
|
+
scroll, each slide earns the next swipe, people would save or send it, the app shows up as the
|
|
65
|
+
payoff not the opener, native look, not a banner ad), each 1 to 5. A finalist with a criterion below 3
|
|
63
66
|
that the layout could have fixed (`stacked` or `split` on 9:16, a dead panel) counts against it.
|
|
64
67
|
- Realism: a generated photo that looks AI-made (waxy, duplicated objects, warped hands) counts against the finalist.
|
|
65
68
|
- Whether the picture and the words do different jobs (photo shows, words claim) rather than
|
|
@@ -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
|
|
@@ -273,6 +283,9 @@ broadly.
|
|
|
273
283
|
|
|
274
284
|
## Finished images (carousel or single still)
|
|
275
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
|
+
|
|
276
289
|
When the slides are already designed (Figma exports, your own renderer, device-framed screenshots)
|
|
277
290
|
there is nothing for the brand layout to do, so use a CAROUSEL Creative: finished images posted
|
|
278
291
|
as-is. A one-slide CAROUSEL is a finished still. For text on a photo that Conductor should lay out,
|