← PicsartCONTENT HISTORY

Update to Picsart

Snapshot Nov 11, 2026 · 00:08 UTC · version 2.5.0

Collection source: downloaded plugin package.

WHAT CHANGED

Instructions updated for make-comics

Full description — Now says: of drawn pages, an illustrated tale, a video comic or video tale,

Observed in instructions or declared skills. Runtime behavior has not been tested.

Save Picsart and check future changes in Following.

Up to 3 plugins free · no card required.

All fields and original values.

Full description

Before

Nov 7, 2026 · 00:09 UTC

book of drawn pages, an illustrated tale, an animated video, a motion episode,

After

Nov 11, 2026 · 00:08 UTC

of drawn pages, an illustrated tale, a video comic or video tale,

Skill instructions

Before

Nov 7, 2026 · 00:09 UTC

book of drawn pages, an illustrated tale, an animated video, a motion episode, a short reel, a narrated quote video or an anime series from several photos - with the person in the photo as its hero, a second person from a second photo if...

After

Nov 11, 2026 · 00:08 UTC

of drawn pages, an illustrated tale, a video comic or video tale, a short reel, a narrated quote video or an anime series from several photos - with the person in the photo as its hero, a second person from a second photo if they want on...

Supporting files

Before

Nov 7, 2026 · 00:09 UTC

[{"relative_path":"agents/openai.yaml","size_in_bytes":183}]

After

Nov 11, 2026 · 00:08 UTC

[{"relative_path":"agents/openai.yaml","size_in_bytes":184}]

Compare saved observations

Download comparison JSON

SKILL.md text changes

− removed · + added

--- before
+++ after
@@ -1,9 +1,9 @@
 ---
 name: make-comics
-description: Turn a photo into a ComicMe creation - a comic book of drawn pages, an illustrated tale, an animated video, a motion episode, a short reel, a narrated quote video or an anime series from several photos - with the person in the photo as its hero, a second person from a second photo if they want one, in a genre, art style and tone they pick, with the price said before anything is charged and every page or clip shown when it is made. Use when the user wants a comic, a tale, a reel, an animated video or a series made from a photo of themselves or someone else, or asks what they would look like as a comic hero.
+description: Turn a photo into a ComicMe creation - a comic of drawn pages, an illustrated tale, a video comic or video tale, a short reel, a narrated quote video or an anime series from several photos - with the person in the photo as its hero, a second person from a second photo if they want one, in a genre, art style and tone they pick, with the price said before anything is charged and every page or clip shown when it is made. Use when the user wants a comic, a tale, a reel, an animated video or a series made from a photo of themselves or someone else, or asks what they would look like as a comic hero.
 metadata:
   title: Make comics
-  short-description: Turn a photo into a comic book, video, reel or anime series
+  short-description: Turn a photo into a comic, tale, video, reel or anime series
   argument-hint: '[the photo and the comic you want]'
   starter-prompt: Turn my photo into a ComicMe creation.
 ---
@@ -12,89 +12,80 @@
 
 Read the `picsart-video-rules` skill first. One job: a photo of a person in; a ComicMe creation
 out, with the person as its hero. ComicMe makes six things from a photo, each through its own
-tool, and this use case covers them all: the user picks one first (stage 1), then the photos,
-then the settings, and every one is quoted before anything is charged. The stages below are
-written for the comic book and apply to each of the others the same way, with that tool's schema
-in place of `picsart_comic_create`'s (see "Each thing ComicMe makes" at the end). A poster or a
-single picture is another use case: when the user wants one of those, start that use case instead.
+tool, and this use case covers them all: the user picks one and its settings on the setup console
+(stage 1), then the photos, and every one is quoted before anything is charged. The stages below
+are written for the comic book and apply to each of the others the same way, with that tool's
+schema in place of `picsart_comic_create`'s (see "Each thing ComicMe makes" at the end). A poster
+or a single picture is another use case: when the user wants one of those, start that use case
+instead.
 
 | Stage | Gate | Skills |
 |---|---|---|
-| 1. What to make | ASK | — |
-| 2. The genre | ASK | — |
-| 3. The art style | ASK | — |
-| 4. The length | ASK | — |
-| 5. The photos, as URLs | ASK | — |
-| 6. The quote | SPEND | — |
-| 7. Draw it | — | — |
-| 8. Show it | SHOW | — |
-
-## 1. What to make
-
-The choice comes before anything else, the photo included. When the request already names it
-("make me a reel", "an anime series of us"), take it and go on. Otherwise ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says), the comic book
-first, one line each on what comes out. Stages 1 to 4 are boards of buttons, never lists the
-user answers by typing, one per turn, as the `picsart-video-rules` skill says under How you talk
-to the user. Where the host has no question tool of its own, the board is `picsart_ask`, one
-question per call, its answer read from the user's next turn, with `recommended` left unset: the
-option to take first is simply first, and no badge says so. The quote's yes in stage 6 is never
-put on that board.
-
-- **A comic book**: drawn pages with them as the hero, `picsart_comic_create`.
-- **A tale**: an illustrated storybook, `picsart_comic_create_tale`.
-- **An animated video**: pages drawn and animated into one narrated video,
-  `picsart_comic_create_video`.
-- **A motion episode**: a vertical video of several animated shots with speech and music,
-  `picsart_comic_create_episode`.
-- **A reel**: one short vertical clip, `picsart_comic_create_reel`.
-- **An anime series**: several episodes from a story idea and the characters' photos,
-  `picsart_comic_create_series`.
-
-A narrated quote video, `picsart_comic_create_aphorism`, needs no photo: offer it only when the user
-asks for words on screen rather than themselves. Keep the choice in the project record; the stages
-below name that tool wherever they say `picsart_comic_create`.
-
-## 2. The genre
-
-Read the request before you ask (the `picsart-video-rules` skill's Asking): a value the request
-already named ("make me a horror comic") is taken and said back, and its board is skipped. That
-holds for stages 2 to 4. The values and their defaults are in `picsart_comic_create`'s own
-schema, never written here.
-
-The genre (`genre`): one board, 2–4 of the schema's values, the default first, each with one line
-on the world it draws the hero into.
-
-## 3. The art style
-
-The art style (`artStyle`): one board, 2–4 of the schema's values, the default first, each with
-one line on the line and colour it gives every page.
-
-## 4. The length
-
-How many pages (`pageCount`): one board, the default first, then more, within the schema's limit;
-more pages cost more and take longer. The other creations ask their own length from their schema
-the same way, one board: a reel's `durationSeconds`, an episode's `shotCount`, a series'
-`totalEpisodes`.
-
-Derive, then say: the tone (`tone`) follows the genre or the user's words, from the schema's
-values, or is left to the tool; the language (`language`) is the language they wrote in.
-
-Ideas get words, not options. When the user tells their own story, keep it as `plot`, with a
-`title`, a `heroName` and a `nemesisName` when they gave them: the tool then draws their story
-under the premise "Custom". Otherwise leave `premise` to the tool. Never ask for a story the
-user did not offer: a comic needs none.
-
-"Just make it" takes the defaults and says them as assumed (Asking, rule 6).
-
-## 5. The photos, as URLs
-
-After the last setting's answer, open `picsart_drive_upload_ask` for the hero's photo, and say in
-its prompt that a second person can join from a second photo: the friend of a comic book
-(`friendImage`), the companion of a tale (`companionImage`), either of those for a video or an
-episode by its style, the `secondaryImage` of a reel. An anime series takes every character's
-photo in that one panel, the first the protagonist (`characterImages`). Ask for all of them in
-that first panel, as the `picsart-video-rules` skill says under Asset URLs; the panel is the ASK,
-and the URLs arrive with the user's next message.
+| 1. The setup, on the console | ASK | — |
+| 2. The photos, as URLs | ASK | — |
+| 3. The quote | SPEND | — |
+| 4. Draw it | — | — |
+| 5. Show it | SHOW | — |
+
+## 1. The setup, on the console
+
+A message asking to open Comic Setup again (the result panel's Open Comic Setup button sends one
+after a creation) is this stage once more: open the console, with `heroImage` when the hero's photo
+is already known, and treat its next lock as a new setup.
+
+**`picsart_comic_setup` comes first**, before the photos and before a word of story. The console is
+the ASK for everything at once: what to make, a comic (`picsart_comic_create`), a tale
+(`picsart_comic_create_tale`), a video comic or a video tale (`picsart_comic_create_video`, by its
+`style`), a reel (`picsart_comic_create_reel`) or an anime series (`picsart_comic_create_series`),
+and that creation's settings: for the comic the genre (`genre`), the art style (`artStyle`), the
+tone (`tone`), the premise (`premise`) and how many pages (`pageCount`); for the others their own
+look and length, and for a series its story idea (`storyIdea`). It offers the values the Picsart app
+offers, every one a value the tool's schema accepts, with the defaults chosen, so no value is
+written here. One panel, one lock: never a question in the chat for what the console asks. Read the
+request before you open it (the `picsart-video-rules` skill's Asking): most say the hero and the
+mood in one line ("make me a horror comic").
+
+- Pass `creation` when the words name what to make ("make me a reel"), and what they decide as
+  `suggested.selections` under the tool's own input names, one `suggested.why` line each: the
+  genre the words name, the pages when they said a number, a series' story idea when they told
+  one, and the language (`language`) they wrote in when it is not English. Pass only what the
+  words decide; the console's defaults stand otherwise.
+- Pass the hero's photo as `heroImage` when its URL is already known (stage 2), so the console
+  shows it. Open the console in full screen where the host supports it.
+- The console is the ASK. On `comic_setup_feedback` (`verdict: "locked"`), its `tool` is the one
+  to call and its `selections` go to that tool unchanged, with `language` when present; its
+  `estimatedCredits` is the cost the console showed next to the lock, for stage 3. That
+  lock is the setup's lock; to change it later, open the console again with `current`.
+- A "Custom" kind of story (`premise`, or a tale look's `talePremise`) means the user tells
+  their own story: ask for it only then, in one question, and pass it under the inputs the
+  lock's reply names, which differ by tool and look: the comic's and video comic's `plot`, with
+  a `title`, a `heroName` and a `nemesisName` when they gave them; a tale's `plot` with its
+  `companionName`; a video tale's `talePlot`, `taleTitle` and `taleHeroName`; a reel's `story`
+  with its `secondaryName`. Any other kind of story needs none. Never ask for a story the user
+  did not offer: a comic needs none, and only the series requires one, which the console
+  collects.
+- A narrated quote video, `picsart_comic_create_aphorism`, needs no photo and no console: offer
+  it only when the user asks for words on screen rather than themselves, and take its `text` and
+  `author` in the chat.
+
+"Just make it" still opens the console: locking it is one tap, and it is where the defaults are
+said (Asking, rule 6).
+
+Where the host notes say the console is not served, ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) what to make, then its settings, in
+the chat instead, one question each, on `picsart_ask` where the host has no question tool of its
+own: 2–4 of the schema's values with the default first, and one line on what each does. Derive
+the tone from the genre or the user's words.
+
+## 2. The photos, as URLs
+
+After the lock, open `picsart_drive_upload_ask` for the hero's photo, and say in its prompt that
+a second person can join from a second photo: the friend of a comic or a video comic
+(`friendImage`), the companion of a tale or a video tale (`companionImage`), the
+`secondaryImage` of a reel. An anime series takes its cast in that one panel
+(`characterImages`): the main role's photo first, then the secondary role's, then any other
+character's, up to the schema's limit; the first is the protagonist. Ask for all of them in that
+first panel, as the `picsart-video-rules` skill says under Asset URLs; the panel is the ASK, and
+the URLs arrive with the user's next message.
 
 Each goes in as an https URL a Picsart tool returned in this conversation, as those same rules
 say (a link or an attachment with `picsart_drive_upload`, a photo in their Picsart Drive with
@@ -102,17 +93,19 @@
 `picsart_upload_local_files`, as its description says. The hero's URL is `heroImage`. One upload
 serves the whole conversation.
 
-## 6. The quote
+## 3. The quote
 
-`picsart_comic_create` charges credits for every page it draws, and gives no quote of its own: say
-that each page is charged, that the amount is not known in advance, and the balance from
-`picsart_credits`, in one message, then SPEND (quote it in one line, then get the yes as an ASK with "Yes, go ahead" / "Yes, up to N credits for this task" / "No": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit ("as much as needed"), never inferred from words like "go ahead". Within it, ask nothing: quote it in one line ("About 8 credits; 12 of 20 left after this"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says). A page the
-tool could not draw is not charged. When the balance looks short, offer fewer pages. When the
-result carries a link to top up, give it exactly as returned.
+The lock's `estimatedCredits` is the cost of this setup as the console showed it: the Picsart
+price of one page, clip or episode times the count, the same price the tool charges when the job
+starts. Say that cost in one message, as "This comic costs 21 credits", then SPEND (quote it in one line, then get the yes as an ASK with "Yes, go ahead" / "Yes, up to N credits for this task" / "No": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit ("as much as needed"), never inferred from words like "go ahead". Within it, ask nothing: quote it in one line ("About 8 credits; 12 of 20 left after this"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says): no call of
+your own for a price or a balance before it. A page or episode the tool could not make is not
+charged. When the lock carries no `estimatedCredits`, say that each page, clip or episode is
+charged. When the result carries a link to top up, give it exactly as returned.
 
-## 7. Draw it
+## 4. Draw it
 
-One `picsart_comic_create` call, with every input from stages 1 to 5. It answers with a job
+One `picsart_comic_create` call (the lock's `tool`, for another creation), with every input from
+stages 1 and 2. It answers with a job
 receipt, not the comic: drawing takes a few minutes. Pass the receipt's `job` verbatim to
 `picsart_job_status` until it reports the result, as the `picsart-video-rules` skill's Tools says.
 While it
@@ -122,7 +115,7 @@
 A FAILED job carries a user-facing `error`: give it, and offer another photo or fewer pages, which
 is a new SPEND.
 
-## 8. Show it
+## 5. Show it
 
 COMPLETED carries `result.pages`, each with its `page` number and `url`, the same pages in order
 as image assets in `result.assets`, and `result.comicId`.
@@ -137,7 +130,7 @@
 
 ## Each thing ComicMe makes
 
-Stage 1's choice names the tool. Each is a job like the comic's: the same stages, the same quote
+The console's lock names the tool. Each is a job like the comic's: the same stages, the same quote
 before anything is charged, the same `picsart_job_status` polling with the receipt's `job`
 verbatim, and never a second call while the job runs. The values and their defaults are in each
 tool's own schema.
@@ -145,12 +138,9 @@
 - **A tale**, an illustrated storybook: `picsart_comic_create_tale`, with a `setting`, `artStyle`,
   `tone`, `theme` and `premise` of its own and a `companionImage` for a second person; charged per
   page; its result carries `result.taleId`.
-- **An animated video** drawn from the photo and narrated: `picsart_comic_create_video`, in the
-  comic or tale `style`; charged per page; its result carries `result.url` and `result.videoId`.
-- **A motion episode**, a vertical video of several animated shots with speech and music, as long
-  as its `shotCount` and `clipSeconds` make it, within the schema's bounds:
-  `picsart_comic_create_episode`; charged once; its result carries `result.url` and
-  `result.episodeId`.
+- **A video comic or a video tale**, drawn from the photo and narrated:
+  `picsart_comic_create_video`, in the comic or tale `style`; charged per page; its result
+  carries `result.url` and `result.videoId`.
 - **A reel**, one short vertical clip, as long as its `durationSeconds` within the schema's bounds:
   `picsart_comic_create_reel`, with the user's own `story` when they told one and a
   `secondaryImage` for a second person; charged once; its result carries `result.url` and
@@ -163,11 +153,37 @@
   per finished episode, and the job runs a long time; its result carries `result.episodes`,
   `result.fullVideoUrl` when there is one, and `result.seriesId`. Say the length and the per-episode
   charge before the quote.
+  Episode by episode instead, when the user wants to see one before the next: the same call with
+  `firstEpisodeOnly: true` plans the arc and makes episode 1 alone, charged as one episode; then each
+  **next episode** is `picsart_comic_continue_series` with `seriesId` and, when they said what happens,
+  `episodeIdea`, charged as one episode: say that charge, then SPEND (quote it in one line, then get the yes as an ASK with "Yes, go ahead" / "Yes, up to N credits for this task" / "No": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit ("as much as needed"), never inferred from words like "go ahead". Within it, ask nothing: quote it in one line ("About 8 credits; 12 of 20 left after this"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says), every time; its result carries
+  `result.url`, `result.episode` and `result.episodeId`. A refusal naming an unfinished episode means
+  `picsart_comic_retry_episode` with that `episodeId` first, charged as one episode, so SPEND (quote it in one line, then get the yes as an ASK with "Yes, go ahead" / "Yes, up to N credits for this task" / "No": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit ("as much as needed"), never inferred from words like "go ahead". Within it, ask nothing: quote it in one line ("About 8 credits; 12 of 20 left after this"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says) again. A
+  series made with every episode at once has no next one. `picsart_comic_export_series` cuts the finished
+  episodes into one video, free; `picsart_comic_replan_series` rewrites the episodes not yet made for
+  the user's `reason`, free, and the finished ones stay.
 - **A video of a comic or tale that already exists**: `picsart_comic_export_video` with the
   `comicId` or `taleId` kept in the project record; free; its result carries `result.url`.
+- **A video comic or tale made again** from the same pages: `picsart_comic_regenerate_video` with
+  the `videoId` kept in the project record; free, and the earlier video is replaced, so say so first.
 
 A video or a clip is SHOWN as its link, the way a page is; a series is shown episode by episode.
 
+## Changing a book that exists
+
+A comic or tale the user already has, named by the `comicId` or `taleId` in the project record, is
+changed without drawing it again. Each change is a job like the comic's, polled the same way with
+the receipt's `job`, and its result carries the whole book's `result.pages` again.
+
+- **More pages**: `picsart_comic_add_page` with `pageCount`; each added page is charged at the
+  comic's per-page price, so say the count and that charge, then SPEND (quote it in one line, then get the yes as an ASK with "Yes, go ahead" / "Yes, up to N credits for this task" / "No": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit ("as much as needed"), never inferred from words like "go ahead". Within it, ask nothing: quote it in one line ("About 8 credits; 12 of 20 left after this"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says). `result.addedPages`
+  names the new pages: SHOW those.
+- **A page drawn again**: `picsart_comic_rewrite_page` with the `page` number (0 is the cover);
+  charged as one page, and the old page is gone, so say both, then SPEND (quote it in one line, then get the yes as an ASK with "Yes, go ahead" / "Yes, up to N credits for this task" / "No": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit ("as much as needed"), never inferred from words like "go ahead". Within it, ask nothing: quote it in one line ("About 8 credits; 12 of 20 left after this"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says).
+- **A page removed**: `picsart_comic_delete_page` with the `page` number; free, and it cannot be
+  undone, so ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) first, "Delete page 2? It can't be brought back." / "Keep it", and call it only on
+  the first.
+
 ## When a call fails
 
 - **The photo refused** ("URL refused", a local path): get a URL (stage 2), then call again.
Full technical diff · 3 changed fields

changed /description

BEFORE
"Turn a photo into a ComicMe creation - a comic book of drawn pages, an illustrated tale, an animated video, a motion episode, a short reel, a narrated quote video or an anime series from several photos - with the person in the photo as its hero, a second person from a second photo if they want one, in a genre, art style and tone they pick, with the price said before anything is charged and every page or clip shown when it is made. Use when the user wants a comic, a tale, a reel, an animated video or a series made from a photo of themselves or someone else, or asks what they would look like as a comic hero."
AFTER
"Turn a photo into a ComicMe creation - a comic of drawn pages, an illustrated tale, a video comic or video tale, a short reel, a narrated quote video or an anime series from several photos - with the person in the photo as its hero, a second person from a second photo if they want one, in a genre, art style and tone they pick, with the price said before anything is charged and every page or clip shown when it is made. Use when the user wants a comic, a tale, a reel, an animated video or a series made from a photo of themselves or someone else, or asks what they would look like as a comic hero."

changed /included_files

BEFORE
[
  {
    "relative_path": "agents/openai.yaml",
    "size_in_bytes": 183
  }
]
AFTER
[
  {
    "relative_path": "agents/openai.yaml",
    "size_in_bytes": 184
  }
]

changed /skill_md_contents

BEFORE
"---\nname: make-comics\ndescription: Turn a photo into a ComicMe creation - a comic book of drawn pages, an illustrated tale, an animated video, a motion episode, a short reel, a narrated quote video or an anime series from several photos - with the person in the photo as its hero, a second person from a second photo if they want one, in a genre, art style and tone they pick, with the price said before anything is charged and every page or clip shown when it is made. Use when the user wants a comic, a tale, a reel, an animated video or a series made from a photo of themselves or someone else, or asks what they would look like as a comic hero.\nmetadata:\n  title: Make comics\n  short-description: Turn a photo into a comic book, video, reel or anime series\n  argument-hint: '[the photo and the comic you want]'\n  starter-prompt: Turn my photo into a ComicMe creation.\n---\n\n# Make a comic from a photo\n\nRead the `picsart-video-rules` skill first. One job: a photo of a person in; a ComicMe creation\nout, with the person as its hero. ComicMe makes six things from a photo, each through its own\ntool, and this use case covers them all: the user picks one first (stage 1), then the photos,\nthen the settings, and every one is quoted before anything is charged. The stages below are\nwritten for the comic book and apply to each of the others the same way, with that tool's schema\nin place of `picsart_comic_create`'s (see \"Each thing ComicMe makes\" at the end). A poster or a\nsingle picture is another use case: when the user wants one of those, start that use case instead.\n\n| Stage | Gate | Skills |\n|---|---|---|\n| 1. What to make | ASK | — |\n| 2. The genre | ASK | — |\n| 3. The art style | ASK | — |\n| 4. The length | ASK | — |\n| 5. The photos, as URLs | ASK | — |\n| 6. The quote | SPEND | — |\n| 7. Draw it | — | — |\n| 8. Show it | SHOW | — |\n\n## 1. What to make\n\nThe choice comes before anything else, the photo included. When the request already names it\n(\"make me a reel\", \"an anime series of us\"), take it and go on. Otherwise ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says), the comic book\nfirst, one line each on what comes out. Stages 1 to 4 are boards of buttons, never lists the\nuser answers by typing, one per turn, as the `picsart-video-rules` skill says under How you talk\nto the user. Where the host has no question tool of its own, the board is `picsart_ask`, one\nquestion per call, its answer read from the user's next turn, with `recommended` left unset: the\noption to take first is simply first, and no badge says so. The quote's yes in stage 6 is never\nput on that board.\n\n- **A comic book**: drawn pages with them as the hero, `picsart_comic_create`.\n- **A tale**: an illustrated storybook, `picsart_comic_create_tale`.\n- **An animated video**: pages drawn and animated into one narrated video,\n  `picsart_comic_create_video`.\n- **A motion episode**: a vertical video of several animated shots with speech and music,\n  `picsart_comic_create_episode`.\n- **A reel**: one short vertical clip, `picsart_comic_create_reel`.\n- **An anime series**: several episodes from a story idea and the characters' photos,\n  `picsart_comic_create_series`.\n\nA narrated quote video, `picsart_comic_create_aphorism`, needs no photo: offer it only when the user\nasks for words on screen rather than themselves. Keep the choice in the project record; the stages\nbelow name that tool wherever they say `picsart_comic_create`.\n\n## 2. The genre\n\nRead the request before you ask (the `picsart-video-rules` skill's Asking): a value the request\nalready named (\"make me a horror comic\") is taken and said back, and its board is skipped. That\nholds for stages 2 to 4. The values and their defaults are in `picsart_comic_create`'s own\nschema, never written here.\n\nThe genre (`genre`): one board, 2–4 of the schema's values, the default first, each with one line\non the world it draws the hero into.\n\n## 3. The art style\n\nThe art style (`artStyle`): one board, 2–4 of the schema's values, the default first, each with\none line on the line and colour it gives every page.\n\n## 4. The length\n\nHow many pages (`pageCount`): one board, the default first, then more, within the schema's limit;\nmore pages cost more and take longer. The other creations ask their own length from their schema\nthe same way, one board: a reel's `durationSeconds`, an episode's `shotCount`, a series'\n`totalEpisodes`.\n\nDerive, then say: the tone (`tone`) follows the genre or the user's words, from the schema's\nvalues, or is left to the tool; the language (`language`) is the language they wrote in.\n\nIdeas get words, not options. When the user tells their own story, keep it as `plot`, with a\n`title`, a `heroName` and a `nemesisName` when they gave them: the tool then draws their story\nunder the premise \"Custom\". Otherwise leave `premise` to the tool. Never ask for a story the\nuser did not offer: a comic needs none.\n\n\"Just make it\" takes the defaults and says them as assumed (Asking, rule 6).\n\n## 5. The photos, as URLs\n\nAfter the last setting's answer, open `picsart_drive_upload_ask` for the hero's photo, and say in\nits prompt that a second person can join from a second photo: the friend of a comic book\n(`friendImage`), the companion of a tale (`companionImage`), either of those for a video or an\nepisode by its style, the `secondaryImage` of a reel. An anime series takes every character's\nphoto in that one panel, the first the protagonist (`characterImages`). Ask for all of them in\nthat first panel, as the `picsart-video-rules` skill says under Asset URLs; the panel is the ASK,\nand the URLs arrive with the user's next message.\n\nEach goes in as an https URL a Picsart tool returned in this conversation, as those same rules\nsay (a link or an attachment with `picsart_drive_upload`, a photo in their Picsart Drive with\n`picsart_drive_list`); a file on disk, where you can run shell commands, comes in with\n`picsart_upload_local_files`, as its description says. The hero's URL is `heroImage`. One upload\nserves the whole conversation.\n\n## 6. The quote\n\n`picsart_comic_create` charges credits for every page it draws, and gives no quote of its own: say\nthat each page is charged, that the amount is not known in advance, and the balance from\n`picsart_credits`, in one message, then SPEND (quote it in one line, then get the yes as an ASK with \"Yes, go ahead\" / \"Yes, up to N credits for this task\" / \"No\": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit (\"as much as needed\"), never inferred from words like \"go ahead\". Within it, ask nothing: quote it in one line (\"About 8 credits; 12 of 20 left after this\"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says). A page the\ntool could not draw is not charged. When the balance looks short, offer fewer pages. When the\nresult carries a link to top up, give it exactly as returned.\n\n## 7. Draw it\n\nOne `picsart_comic_create` call, with every input from stages 1 to 5. It answers with a job\nreceipt, not the comic: drawing takes a few minutes. Pass the receipt's `job` verbatim to\n`picsart_job_status` until it reports the result, as the `picsart-video-rules` skill's Tools says.\nWhile it\nruns, say in one line that the pages are being drawn. Never call `picsart_comic_create` again while\nits job runs: a second call draws and charges a second comic.\n\nA FAILED job carries a user-facing `error`: give it, and offer another photo or fewer pages, which\nis a new SPEND.\n\n## 8. Show it\n\nCOMPLETED carries `result.pages`, each with its `page` number and `url`, the same pages in order\nas image assets in `result.assets`, and `result.comicId`.\nSHOW every page as a link, in order, with one line each on what it is: \"the cover\", \"page 1\".\nLook at the cover as the host notes say under \"Looking at an image\", and say in one line what the\nhero looks like in it. A number in `result.failedPages` is a page that could not be drawn: say so,\nand that it was not charged.\n\nKeep `result.comicId` in the project record: it names this comic in a later turn. Then offer one\nnext step in a sentence (another genre, more pages, a comic for the friend), and do it only on a\nyes: it is a new SPEND.\n\n## Each thing ComicMe makes\n\nStage 1's choice names the tool. Each is a job like the comic's: the same stages, the same quote\nbefore anything is charged, the same `picsart_job_status` polling with the receipt's `job`\nverbatim, and never a second call while the job runs. The values and their defaults are in each\ntool's own schema.\n\n- **A tale**, an illustrated storybook: `picsart_comic_create_tale`, with a `setting`, `artStyle`,\n  `tone`, `theme` and `premise` of its own and a `companionImage` for a second person; charged per\n  page; its result carries `result.taleId`.\n- **An animated video** drawn from the photo and narrated: `picsart_comic_create_video`, in the\n  comic or tale `style`; charged per page; its result carries `result.url` and `result.videoId`.\n- **A motion episode**, a vertical video of several animated shots with speech and music, as long\n  as its `shotCount` and `clipSeconds` make it, within the schema's bounds:\n  `picsart_comic_create_episode`; charged once; its result carries `result.url` and\n  `result.episodeId`.\n- **A reel**, one short vertical clip, as long as its `durationSeconds` within the schema's bounds:\n  `picsart_comic_create_reel`, with the user's own `story` when they told one and a\n  `secondaryImage` for a second person; charged once; its result carries `result.url` and\n  `result.episodeId`.\n- **A narrated quote video**, no photo needed: `picsart_comic_create_aphorism`, with the `text`\n  and its `author`; charged once; its result carries `result.url`.\n- **An anime series** of several episodes from a story idea and the characters' photos, as many\n  as the schema's `characterImages` allows: `picsart_comic_create_series`, with `storyIdea`,\n  `characterImages` and `totalEpisodes`; charged\n  per finished episode, and the job runs a long time; its result carries `result.episodes`,\n  `result.fullVideoUrl` when there is one, and `result.seriesId`. Say the length and the per-episode\n  charge before the quote.\n- **A video of a comic or tale that already exists**: `picsart_comic_export_video` with the\n  `comicId` or `taleId` kept in the project record; free; its result carries `result.url`.\n\nA video or a clip is SHOWN as its link, the way a page is; a series is shown episode by episode.\n\n## When a call fails\n\n- **The photo refused** (\"URL refused\", a local path): get a URL (stage 2), then call again.\n- **A setting refused:** read the value from the tool's schema, correct it, and quote again.\n- **The job is not found:** the receipt was changed on the way back. Give what you have, and offer\n  to draw the comic again, which charges again.\n"
AFTER
"---\nname: make-comics\ndescription: Turn a photo into a ComicMe creation - a comic of drawn pages, an illustrated tale, a video comic or video tale, a short reel, a narrated quote video or an anime series from several photos - with the person in the photo as its hero, a second person from a second photo if they want one, in a genre, art style and tone they pick, with the price said before anything is charged and every page or clip shown when it is made. Use when the user wants a comic, a tale, a reel, an animated video or a series made from a photo of themselves or someone else, or asks what they would look like as a comic hero.\nmetadata:\n  title: Make comics\n  short-description: Turn a photo into a comic, tale, video, reel or anime series\n  argument-hint: '[the photo and the comic you want]'\n  starter-prompt: Turn my photo into a ComicMe creation.\n---\n\n# Make a comic from a photo\n\nRead the `picsart-video-rules` skill first. One job: a photo of a person in; a ComicMe creation\nout, with the person as its hero. ComicMe makes six things from a photo, each through its own\ntool, and this use case covers them all: the user picks one and its settings on the setup console\n(stage 1), then the photos, and every one is quoted before anything is charged. The stages below\nare written for the comic book and apply to each of the others the same way, with that tool's\nschema in place of `picsart_comic_create`'s (see \"Each thing ComicMe makes\" at the end). A poster\nor a single picture is another use case: when the user wants one of those, start that use case\ninstead.\n\n| Stage | Gate | Skills |\n|---|---|---|\n| 1. The setup, on the console | ASK | — |\n| 2. The photos, as URLs | ASK | — |\n| 3. The quote | SPEND | — |\n| 4. Draw it | — | — |\n| 5. Show it | SHOW | — |\n\n## 1. The setup, on the console\n\nA message asking to open Comic Setup again (the result panel's Open Comic Setup button sends one\nafter a creation) is this stage once more: open the console, with `heroImage` when the hero's photo\nis already known, and treat its next lock as a new setup.\n\n**`picsart_comic_setup` comes first**, before the photos and before a word of story. The console is\nthe ASK for everything at once: what to make, a comic (`picsart_comic_create`), a tale\n(`picsart_comic_create_tale`), a video comic or a video tale (`picsart_comic_create_video`, by its\n`style`), a reel (`picsart_comic_create_reel`) or an anime series (`picsart_comic_create_series`),\nand that creation's settings: for the comic the genre (`genre`), the art style (`artStyle`), the\ntone (`tone`), the premise (`premise`) and how many pages (`pageCount`); for the others their own\nlook and length, and for a series its story idea (`storyIdea`). It offers the values the Picsart app\noffers, every one a value the tool's schema accepts, with the defaults chosen, so no value is\nwritten here. One panel, one lock: never a question in the chat for what the console asks. Read the\nrequest before you open it (the `picsart-video-rules` skill's Asking): most say the hero and the\nmood in one line (\"make me a horror comic\").\n\n- Pass `creation` when the words name what to make (\"make me a reel\"), and what they decide as\n  `suggested.selections` under the tool's own input names, one `suggested.why` line each: the\n  genre the words name, the pages when they said a number, a series' story idea when they told\n  one, and the language (`language`) they wrote in when it is not English. Pass only what the\n  words decide; the console's defaults stand otherwise.\n- Pass the hero's photo as `heroImage` when its URL is already known (stage 2), so the console\n  shows it. Open the console in full screen where the host supports it.\n- The console is the ASK. On `comic_setup_feedback` (`verdict: \"locked\"`), its `tool` is the one\n  to call and its `selections` go to that tool unchanged, with `language` when present; its\n  `estimatedCredits` is the cost the console showed next to the lock, for stage 3. That\n  lock is the setup's lock; to change it later, open the console again with `current`.\n- A \"Custom\" kind of story (`premise`, or a tale look's `talePremise`) means the user tells\n  their own story: ask for it only then, in one question, and pass it under the inputs the\n  lock's reply names, which differ by tool and look: the comic's and video comic's `plot`, with\n  a `title`, a `heroName` and a `nemesisName` when they gave them; a tale's `plot` with its\n  `companionName`; a video tale's `talePlot`, `taleTitle` and `taleHeroName`; a reel's `story`\n  with its `secondaryName`. Any other kind of story needs none. Never ask for a story the user\n  did not offer: a comic needs none, and only the series requires one, which the console\n  collects.\n- A narrated quote video, `picsart_comic_create_aphorism`, needs no photo and no console: offer\n  it only when the user asks for words on screen rather than themselves, and take its `text` and\n  `author` in the chat.\n\n\"Just make it\" still opens the console: locking it is one tap, and it is where the defaults are\nsaid (Asking, rule 6).\n\nWhere the host notes say the console is not served, ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) what to make, then its settings, in\nthe chat instead, one question each, on `picsart_ask` where the host has no question tool of its\nown: 2–4 of the schema's values with the default first, and one line on what each does. Derive\nthe tone from the genre or the user's words.\n\n## 2. The photos, as URLs\n\nAfter the lock, open `picsart_drive_upload_ask` for the hero's photo, and say in its prompt that\na second person can join from a second photo: the friend of a comic or a video comic\n(`friendImage`), the companion of a tale or a video tale (`companionImage`), the\n`secondaryImage` of a reel. An anime series takes its cast in that one panel\n(`characterImages`): the main role's photo first, then the secondary role's, then any other\ncharacter's, up to the schema's limit; the first is the protagonist. Ask for all of them in that\nfirst panel, as the `picsart-video-rules` skill says under Asset URLs; the panel is the ASK, and\nthe URLs arrive with the user's next message.\n\nEach goes in as an https URL a Picsart tool returned in this conversation, as those same rules\nsay (a link or an attachment with `picsart_drive_upload`, a photo in their Picsart Drive with\n`picsart_drive_list`); a file on disk, where you can run shell commands, comes in with\n`picsart_upload_local_files`, as its description says. The hero's URL is `heroImage`. One upload\nserves the whole conversation.\n\n## 3. The quote\n\nThe lock's `estimatedCredits` is the cost of this setup as the console showed it: the Picsart\nprice of one page, clip or episode times the count, the same price the tool charges when the job\nstarts. Say that cost in one message, as \"This comic costs 21 credits\", then SPEND (quote it in one line, then get the yes as an ASK with \"Yes, go ahead\" / \"Yes, up to N credits for this task\" / \"No\": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit (\"as much as needed\"), never inferred from words like \"go ahead\". Within it, ask nothing: quote it in one line (\"About 8 credits; 12 of 20 left after this\"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says): no call of\nyour own for a price or a balance before it. A page or episode the tool could not make is not\ncharged. When the lock carries no `estimatedCredits`, say that each page, clip or episode is\ncharged. When the result carries a link to top up, give it exactly as returned.\n\n## 4. Draw it\n\nOne `picsart_comic_create` call (the lock's `tool`, for another creation), with every input from\nstages 1 and 2. It answers with a job\nreceipt, not the comic: drawing takes a few minutes. Pass the receipt's `job` verbatim to\n`picsart_job_status` until it reports the result, as the `picsart-video-rules` skill's Tools says.\nWhile it\nruns, say in one line that the pages are being drawn. Never call `picsart_comic_create` again while\nits job runs: a second call draws and charges a second comic.\n\nA FAILED job carries a user-facing `error`: give it, and offer another photo or fewer pages, which\nis a new SPEND.\n\n## 5. Show it\n\nCOMPLETED carries `result.pages`, each with its `page` number and `url`, the same pages in order\nas image assets in `result.assets`, and `result.comicId`.\nSHOW every page as a link, in order, with one line each on what it is: \"the cover\", \"page 1\".\nLook at the cover as the host notes say under \"Looking at an image\", and say in one line what the\nhero looks like in it. A number in `result.failedPages` is a page that could not be drawn: say so,\nand that it was not charged.\n\nKeep `result.comicId` in the project record: it names this comic in a later turn. Then offer one\nnext step in a sentence (another genre, more pages, a comic for the friend), and do it only on a\nyes: it is a new SPEND.\n\n## Each thing ComicMe makes\n\nThe console's lock names the tool. Each is a job like the comic's: the same stages, the same quote\nbefore anything is charged, the same `picsart_job_status` polling with the receipt's `job`\nverbatim, and never a second call while the job runs. The values and their defaults are in each\ntool's own schema.\n\n- **A tale**, an illustrated storybook: `picsart_comic_create_tale`, with a `setting`, `artStyle`,\n  `tone`, `theme` and `premise` of its own and a `companionImage` for a second person; charged per\n  page; its result carries `result.taleId`.\n- **A video comic or a video tale**, drawn from the photo and narrated:\n  `picsart_comic_create_video`, in the comic or tale `style`; charged per page; its result\n  carries `result.url` and `result.videoId`.\n- **A reel**, one short vertical clip, as long as its `durationSeconds` within the schema's bounds:\n  `picsart_comic_create_reel`, with the user's own `story` when they told one and a\n  `secondaryImage` for a second person; charged once; its result carries `result.url` and\n  `result.episodeId`.\n- **A narrated quote video**, no photo needed: `picsart_comic_create_aphorism`, with the `text`\n  and its `author`; charged once; its result carries `result.url`.\n- **An anime series** of several episodes from a story idea and the characters' photos, as many\n  as the schema's `characterImages` allows: `picsart_comic_create_series`, with `storyIdea`,\n  `characterImages` and `totalEpisodes`; charged\n  per finished episode, and the job runs a long time; its result carries `result.episodes`,\n  `result.fullVideoUrl` when there is one, and `result.seriesId`. Say the length and the per-episode\n  charge before the quote.\n  Episode by episode instead, when the user wants to see one before the next: the same call with\n  `firstEpisodeOnly: true` plans the arc and makes episode 1 alone, charged as one episode; then each\n  **next episode** is `picsart_comic_continue_series` with `seriesId` and, when they said what happens,\n  `episodeIdea`, charged as one episode: say that charge, then SPEND (quote it in one line, then get the yes as an ASK with \"Yes, go ahead\" / \"Yes, up to N credits for this task\" / \"No\": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit (\"as much as needed\"), never inferred from words like \"go ahead\". Within it, ask nothing: quote it in one line (\"About 8 credits; 12 of 20 left after this\"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says), every time; its result carries\n  `result.url`, `result.episode` and `result.episodeId`. A refusal naming an unfinished episode means\n  `picsart_comic_retry_episode` with that `episodeId` first, charged as one episode, so SPEND (quote it in one line, then get the yes as an ASK with \"Yes, go ahead\" / \"Yes, up to N credits for this task\" / \"No\": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit (\"as much as needed\"), never inferred from words like \"go ahead\". Within it, ask nothing: quote it in one line (\"About 8 credits; 12 of 20 left after this\"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says) again. A\n  series made with every episode at once has no next one. `picsart_comic_export_series` cuts the finished\n  episodes into one video, free; `picsart_comic_replan_series` rewrites the episodes not yet made for\n  the user's `reason`, free, and the finished ones stay.\n- **A video of a comic or tale that already exists**: `picsart_comic_export_video` with the\n  `comicId` or `taleId` kept in the project record; free; its result carries `result.url`.\n- **A video comic or tale made again** from the same pages: `picsart_comic_regenerate_video` with\n  the `videoId` kept in the project record; free, and the earlier video is replaced, so say so first.\n\nA video or a clip is SHOWN as its link, the way a page is; a series is shown episode by episode.\n\n## Changing a book that exists\n\nA comic or tale the user already has, named by the `comicId` or `taleId` in the project record, is\nchanged without drawing it again. Each change is a job like the comic's, polled the same way with\nthe receipt's `job`, and its result carries the whole book's `result.pages` again.\n\n- **More pages**: `picsart_comic_add_page` with `pageCount`; each added page is charged at the\n  comic's per-page price, so say the count and that charge, then SPEND (quote it in one line, then get the yes as an ASK with \"Yes, go ahead\" / \"Yes, up to N credits for this task\" / \"No\": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit (\"as much as needed\"), never inferred from words like \"go ahead\". Within it, ask nothing: quote it in one line (\"About 8 credits; 12 of 20 left after this\"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says). `result.addedPages`\n  names the new pages: SHOW those.\n- **A page drawn again**: `picsart_comic_rewrite_page` with the `page` number (0 is the cover);\n  charged as one page, and the old page is gone, so say both, then SPEND (quote it in one line, then get the yes as an ASK with \"Yes, go ahead\" / \"Yes, up to N credits for this task\" / \"No\": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit (\"as much as needed\"), never inferred from words like \"go ahead\". Within it, ask nothing: quote it in one line (\"About 8 credits; 12 of 20 left after this\"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says).\n- **A page removed**: `picsart_comic_delete_page` with the `page` number; free, and it cannot be\n  undone, so ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) first, \"Delete page 2? It can't be brought back.\" / \"Keep it\", and call it only on\n  the first.\n\n## When a call fails\n\n- **The photo refused** (\"URL refused\", a local path): get a URL (stage 2), then call again.\n- **A setting refused:** read the value from the tool's schema, correct it, and quote again.\n- **The job is not found:** the receipt was changed on the way back. Give what you have, and offer\n  to draw the comic again, which charges again.\n"
Full snapshot data
{
  "description": "Turn a photo into a ComicMe creation - a comic of drawn pages, an illustrated tale, a video comic or video tale, a short reel, a narrated quote video or an anime series from several photos - with the person in the photo as its hero, a second person from a second photo if they want one, in a genre, art style and tone they pick, with the price said before anything is charged and every page or clip shown when it is made. Use when the user wants a comic, a tale, a reel, an animated video or a series made from a photo of themselves or someone else, or asks what they would look like as a comic hero.",
  "included_files": [
    {
      "relative_path": "agents/openai.yaml",
      "size_in_bytes": 184
    }
  ],
  "name": "make-comics",
  "skill_md_contents": "---\nname: make-comics\ndescription: Turn a photo into a ComicMe creation - a comic of drawn pages, an illustrated tale, a video comic or video tale, a short reel, a narrated quote video or an anime series from several photos - with the person in the photo as its hero, a second person from a second photo if they want one, in a genre, art style and tone they pick, with the price said before anything is charged and every page or clip shown when it is made. Use when the user wants a comic, a tale, a reel, an animated video or a series made from a photo of themselves or someone else, or asks what they would look like as a comic hero.\nmetadata:\n  title: Make comics\n  short-description: Turn a photo into a comic, tale, video, reel or anime series\n  argument-hint: '[the photo and the comic you want]'\n  starter-prompt: Turn my photo into a ComicMe creation.\n---\n\n# Make a comic from a photo\n\nRead the `picsart-video-rules` skill first. One job: a photo of a person in; a ComicMe creation\nout, with the person as its hero. ComicMe makes six things from a photo, each through its own\ntool, and this use case covers them all: the user picks one and its settings on the setup console\n(stage 1), then the photos, and every one is quoted before anything is charged. The stages below\nare written for the comic book and apply to each of the others the same way, with that tool's\nschema in place of `picsart_comic_create`'s (see \"Each thing ComicMe makes\" at the end). A poster\nor a single picture is another use case: when the user wants one of those, start that use case\ninstead.\n\n| Stage | Gate | Skills |\n|---|---|---|\n| 1. The setup, on the console | ASK | — |\n| 2. The photos, as URLs | ASK | — |\n| 3. The quote | SPEND | — |\n| 4. Draw it | — | — |\n| 5. Show it | SHOW | — |\n\n## 1. The setup, on the console\n\nA message asking to open Comic Setup again (the result panel's Open Comic Setup button sends one\nafter a creation) is this stage once more: open the console, with `heroImage` when the hero's photo\nis already known, and treat its next lock as a new setup.\n\n**`picsart_comic_setup` comes first**, before the photos and before a word of story. The console is\nthe ASK for everything at once: what to make, a comic (`picsart_comic_create`), a tale\n(`picsart_comic_create_tale`), a video comic or a video tale (`picsart_comic_create_video`, by its\n`style`), a reel (`picsart_comic_create_reel`) or an anime series (`picsart_comic_create_series`),\nand that creation's settings: for the comic the genre (`genre`), the art style (`artStyle`), the\ntone (`tone`), the premise (`premise`) and how many pages (`pageCount`); for the others their own\nlook and length, and for a series its story idea (`storyIdea`). It offers the values the Picsart app\noffers, every one a value the tool's schema accepts, with the defaults chosen, so no value is\nwritten here. One panel, one lock: never a question in the chat for what the console asks. Read the\nrequest before you open it (the `picsart-video-rules` skill's Asking): most say the hero and the\nmood in one line (\"make me a horror comic\").\n\n- Pass `creation` when the words name what to make (\"make me a reel\"), and what they decide as\n  `suggested.selections` under the tool's own input names, one `suggested.why` line each: the\n  genre the words name, the pages when they said a number, a series' story idea when they told\n  one, and the language (`language`) they wrote in when it is not English. Pass only what the\n  words decide; the console's defaults stand otherwise.\n- Pass the hero's photo as `heroImage` when its URL is already known (stage 2), so the console\n  shows it. Open the console in full screen where the host supports it.\n- The console is the ASK. On `comic_setup_feedback` (`verdict: \"locked\"`), its `tool` is the one\n  to call and its `selections` go to that tool unchanged, with `language` when present; its\n  `estimatedCredits` is the cost the console showed next to the lock, for stage 3. That\n  lock is the setup's lock; to change it later, open the console again with `current`.\n- A \"Custom\" kind of story (`premise`, or a tale look's `talePremise`) means the user tells\n  their own story: ask for it only then, in one question, and pass it under the inputs the\n  lock's reply names, which differ by tool and look: the comic's and video comic's `plot`, with\n  a `title`, a `heroName` and a `nemesisName` when they gave them; a tale's `plot` with its\n  `companionName`; a video tale's `talePlot`, `taleTitle` and `taleHeroName`; a reel's `story`\n  with its `secondaryName`. Any other kind of story needs none. Never ask for a story the user\n  did not offer: a comic needs none, and only the series requires one, which the console\n  collects.\n- A narrated quote video, `picsart_comic_create_aphorism`, needs no photo and no console: offer\n  it only when the user asks for words on screen rather than themselves, and take its `text` and\n  `author` in the chat.\n\n\"Just make it\" still opens the console: locking it is one tap, and it is where the defaults are\nsaid (Asking, rule 6).\n\nWhere the host notes say the console is not served, ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) what to make, then its settings, in\nthe chat instead, one question each, on `picsart_ask` where the host has no question tool of its\nown: 2–4 of the schema's values with the default first, and one line on what each does. Derive\nthe tone from the genre or the user's words.\n\n## 2. The photos, as URLs\n\nAfter the lock, open `picsart_drive_upload_ask` for the hero's photo, and say in its prompt that\na second person can join from a second photo: the friend of a comic or a video comic\n(`friendImage`), the companion of a tale or a video tale (`companionImage`), the\n`secondaryImage` of a reel. An anime series takes its cast in that one panel\n(`characterImages`): the main role's photo first, then the secondary role's, then any other\ncharacter's, up to the schema's limit; the first is the protagonist. Ask for all of them in that\nfirst panel, as the `picsart-video-rules` skill says under Asset URLs; the panel is the ASK, and\nthe URLs arrive with the user's next message.\n\nEach goes in as an https URL a Picsart tool returned in this conversation, as those same rules\nsay (a link or an attachment with `picsart_drive_upload`, a photo in their Picsart Drive with\n`picsart_drive_list`); a file on disk, where you can run shell commands, comes in with\n`picsart_upload_local_files`, as its description says. The hero's URL is `heroImage`. One upload\nserves the whole conversation.\n\n## 3. The quote\n\nThe lock's `estimatedCredits` is the cost of this setup as the console showed it: the Picsart\nprice of one page, clip or episode times the count, the same price the tool charges when the job\nstarts. Say that cost in one message, as \"This comic costs 21 credits\", then SPEND (quote it in one line, then get the yes as an ASK with \"Yes, go ahead\" / \"Yes, up to N credits for this task\" / \"No\": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit (\"as much as needed\"), never inferred from words like \"go ahead\". Within it, ask nothing: quote it in one line (\"About 8 credits; 12 of 20 left after this\"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says): no call of\nyour own for a price or a balance before it. A page or episode the tool could not make is not\ncharged. When the lock carries no `estimatedCredits`, say that each page, clip or episode is\ncharged. When the result carries a link to top up, give it exactly as returned.\n\n## 4. Draw it\n\nOne `picsart_comic_create` call (the lock's `tool`, for another creation), with every input from\nstages 1 and 2. It answers with a job\nreceipt, not the comic: drawing takes a few minutes. Pass the receipt's `job` verbatim to\n`picsart_job_status` until it reports the result, as the `picsart-video-rules` skill's Tools says.\nWhile it\nruns, say in one line that the pages are being drawn. Never call `picsart_comic_create` again while\nits job runs: a second call draws and charges a second comic.\n\nA FAILED job carries a user-facing `error`: give it, and offer another photo or fewer pages, which\nis a new SPEND.\n\n## 5. Show it\n\nCOMPLETED carries `result.pages`, each with its `page` number and `url`, the same pages in order\nas image assets in `result.assets`, and `result.comicId`.\nSHOW every page as a link, in order, with one line each on what it is: \"the cover\", \"page 1\".\nLook at the cover as the host notes say under \"Looking at an image\", and say in one line what the\nhero looks like in it. A number in `result.failedPages` is a page that could not be drawn: say so,\nand that it was not charged.\n\nKeep `result.comicId` in the project record: it names this comic in a later turn. Then offer one\nnext step in a sentence (another genre, more pages, a comic for the friend), and do it only on a\nyes: it is a new SPEND.\n\n## Each thing ComicMe makes\n\nThe console's lock names the tool. Each is a job like the comic's: the same stages, the same quote\nbefore anything is charged, the same `picsart_job_status` polling with the receipt's `job`\nverbatim, and never a second call while the job runs. The values and their defaults are in each\ntool's own schema.\n\n- **A tale**, an illustrated storybook: `picsart_comic_create_tale`, with a `setting`, `artStyle`,\n  `tone`, `theme` and `premise` of its own and a `companionImage` for a second person; charged per\n  page; its result carries `result.taleId`.\n- **A video comic or a video tale**, drawn from the photo and narrated:\n  `picsart_comic_create_video`, in the comic or tale `style`; charged per page; its result\n  carries `result.url` and `result.videoId`.\n- **A reel**, one short vertical clip, as long as its `durationSeconds` within the schema's bounds:\n  `picsart_comic_create_reel`, with the user's own `story` when they told one and a\n  `secondaryImage` for a second person; charged once; its result carries `result.url` and\n  `result.episodeId`.\n- **A narrated quote video**, no photo needed: `picsart_comic_create_aphorism`, with the `text`\n  and its `author`; charged once; its result carries `result.url`.\n- **An anime series** of several episodes from a story idea and the characters' photos, as many\n  as the schema's `characterImages` allows: `picsart_comic_create_series`, with `storyIdea`,\n  `characterImages` and `totalEpisodes`; charged\n  per finished episode, and the job runs a long time; its result carries `result.episodes`,\n  `result.fullVideoUrl` when there is one, and `result.seriesId`. Say the length and the per-episode\n  charge before the quote.\n  Episode by episode instead, when the user wants to see one before the next: the same call with\n  `firstEpisodeOnly: true` plans the arc and makes episode 1 alone, charged as one episode; then each\n  **next episode** is `picsart_comic_continue_series` with `seriesId` and, when they said what happens,\n  `episodeIdea`, charged as one episode: say that charge, then SPEND (quote it in one line, then get the yes as an ASK with \"Yes, go ahead\" / \"Yes, up to N credits for this task\" / \"No\": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit (\"as much as needed\"), never inferred from words like \"go ahead\". Within it, ask nothing: quote it in one line (\"About 8 credits; 12 of 20 left after this\"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says), every time; its result carries\n  `result.url`, `result.episode` and `result.episodeId`. A refusal naming an unfinished episode means\n  `picsart_comic_retry_episode` with that `episodeId` first, charged as one episode, so SPEND (quote it in one line, then get the yes as an ASK with \"Yes, go ahead\" / \"Yes, up to N credits for this task\" / \"No\": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit (\"as much as needed\"), never inferred from words like \"go ahead\". Within it, ask nothing: quote it in one line (\"About 8 credits; 12 of 20 left after this\"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says) again. A\n  series made with every episode at once has no next one. `picsart_comic_export_series` cuts the finished\n  episodes into one video, free; `picsart_comic_replan_series` rewrites the episodes not yet made for\n  the user's `reason`, free, and the finished ones stay.\n- **A video of a comic or tale that already exists**: `picsart_comic_export_video` with the\n  `comicId` or `taleId` kept in the project record; free; its result carries `result.url`.\n- **A video comic or tale made again** from the same pages: `picsart_comic_regenerate_video` with\n  the `videoId` kept in the project record; free, and the earlier video is replaced, so say so first.\n\nA video or a clip is SHOWN as its link, the way a page is; a series is shown episode by episode.\n\n## Changing a book that exists\n\nA comic or tale the user already has, named by the `comicId` or `taleId` in the project record, is\nchanged without drawing it again. Each change is a job like the comic's, polled the same way with\nthe receipt's `job`, and its result carries the whole book's `result.pages` again.\n\n- **More pages**: `picsart_comic_add_page` with `pageCount`; each added page is charged at the\n  comic's per-page price, so say the count and that charge, then SPEND (quote it in one line, then get the yes as an ASK with \"Yes, go ahead\" / \"Yes, up to N credits for this task\" / \"No\": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit (\"as much as needed\"), never inferred from words like \"go ahead\". Within it, ask nothing: quote it in one line (\"About 8 credits; 12 of 20 left after this\"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says). `result.addedPages`\n  names the new pages: SHOW those.\n- **A page drawn again**: `picsart_comic_rewrite_page` with the `page` number (0 is the cover);\n  charged as one page, and the old page is gone, so say both, then SPEND (quote it in one line, then get the yes as an ASK with \"Yes, go ahead\" / \"Yes, up to N credits for this task\" / \"No\": the host's own choice tool where it offers one, otherwise those options numbered in one message; the host's own confirmation before a tool runs is not this yes; unless a spend limit the user stated covers it: N credits or an explicit no-limit (\"as much as needed\"), never inferred from words like \"go ahead\". Within it, ask nothing: quote it in one line (\"About 8 credits; 12 of 20 left after this\"), call it, then say what it spent and what remains, keeping a running total that includes failed calls, and stop to ask before the first call that would cross it. A money amount is asked once to restate it in credits; in unattended pace, never ask: call only with a consent or a stated spend limit already recorded, otherwise write the quote to pendingSpends and stop, as picsart-video-rules says).\n- **A page removed**: `picsart_comic_delete_page` with the `page` number; free, and it cannot be\n  undone, so ASK (with the host's own choice tool where it offers one, such as request_user_input in Codex's Plan mode, so the user taps an option; a Picsart board the step names asks there instead; only where neither works, the options numbered in one message, the recommended one first; in unattended pace, never ask: write it to the project record's openDecisions with the answer you assumed, as picsart-video-rules says) first, \"Delete page 2? It can't be brought back.\" / \"Keep it\", and call it only on\n  the first.\n\n## When a call fails\n\n- **The photo refused** (\"URL refused\", a local path): get a URL (stage 2), then call again.\n- **A setting refused:** read the value from the tool's schema, correct it, and quote again.\n- **The job is not found:** the receipt was changed on the way back. Give what you have, and offer\n  to draw the comic again, which charges again.\n"
}

SHA-256 of public snapshot: 951b700aa0e7ba06efac4e8f3cb581dbd115780c99331e1bcaf69e13e7e5e239