Update to Picsart
Snapshot Nov 11, 2026 · 00:08 UTC · version 2.5.0
Collection source: downloaded plugin package.
Instructions updated for generate-media
Skill instructions — Now says: is, except a HEIC photo's (picsart-video-rules's Asset URLs). - an image: `gpt-image-2.6-sunburst`, as picsart-video-rules's Image generation and...
Observed in instructions or declared skills. Runtime behavior has not been tested.
Up to 3 plugins free · no card required.
All fields and original values.
Skill instructions
Nov 7, 2026 · 00:09 UTC
is (picsart-video-rules's Asset URLs). - an image: `gpt-image-2.6-flare` (`flux-2-pro` for a 21:9 or 9:21 frame, which it does not hold). It takes `reasoningEffort`, not `quality`, and no
Nov 11, 2026 · 00:08 UTC
is, except a HEIC photo's (picsart-video-rules's Asset URLs). - an image: `gpt-image-2.6-sunburst`, as picsart-video-rules's Image generation and supplied photos says. Use a supported generation ratio and frame/crop to a wider ca...
Compare saved observations
Download comparison JSONSKILL.md text changes
− removed · + added
--- before +++ after @@ -53,7 +53,7 @@ ## 2. The user's files, as URLs Every input is a URL: `image` on the edit tools, `imageUrls` and `videoUrl` on `picsart_generate`. -A URL a Picsart tool returned in this conversation is passed as it is (picsart-video-rules's Asset URLs). +A URL a Picsart tool returned in this conversation is passed as it is, except a HEIC photo's (picsart-video-rules's Asset URLs). Otherwise: - **A file on disk, and you can run shell commands:** call `picsart_upload_local_files` with each @@ -80,8 +80,12 @@ say: three candidates from `picsart_model_catalog` (`concise: false`), each with what it is best for here, one marked recommended. When they want to look through all of them, open `picsart_model_show` with the `mode` and `purpose: "generate"`. Otherwise choose it yourself: - - an image: `gpt-image-2.6-flare` (`flux-2-pro` for a 21:9 or 9:21 frame, which it does not - hold). It takes `reasoningEffort`, not `quality`, and no `negativePrompt`; + - an image: `gpt-image-2.6-sunburst`, as picsart-video-rules's Image generation and supplied + photos says. Use a supported generation ratio and frame/crop to a wider canvas; never + silently switch models. Its `quality` is `max`, `xhigh`, `high`, `medium` or `low`, + `complexity` is `high`, `medium` or `low`, and `resolution` is `1K`, `2K` or `4K`. + It takes up to 16 `imageUrls` and ratios `1:1`, `3:2`, `2:3`, `16:9`, `9:16`, `4:3`, + `3:4` and `auto`. Recheck the live schema; send neither `reasoningEffort` nor `negativePrompt`; - anything else: `picsart_model_catalog` with the `mode`, `purpose: "generate"`, the `inputType` (`t2v` or `i2v` for a video, `tts` for a voice line, `sfx` for a sound, `music` for a song) and `acceptsImage` or `acceptsVideo` when the user brought one. Take the first
Full technical diff · 1 changed fields
changed /skill_md_contents
"---\nname: generate-media\ndescription: Make an image, a video, a voice line, a sound or a song from a prompt, or edit a picture or product photo - remove or replace its background, enhance or upscale it, or turn it into a vector - with a model that fits, its settings checked and its price quoted before anything is charged. Also answers questions about models, prices, credits and Drive. Use when the user asks to generate, make or create an image, a video or audio, to edit a picture, to browse the models, or about a price, their credits or their Drive files. Load it first, before any tool, when they say not to ask, to work unattended, or set a spend limit. Load it before calling any Picsart model, generation or image tool.\nmetadata:\n uses: film-shot-generation, sd25-pe, sd2-pe\n title: Generate media\n short-description: Make or edit images, video, voice, sound and music\n argument-hint: '[what to make or edit]'\n starter-prompt: Make an image, a video or audio from my prompt.\n---\n\n# Make or edit an image, a video or audio\n\nRead picsart-video-rules first. One job: the user asks for one piece of media, or one edit of a picture,\nand gets it with no failed call and no surprise charge. A whole video project is another use case:\nwhen the user wants their footage cut, a screen recording turned into a video, a film or an\nanimated design, start that use case instead.\n\nBefore acting on a stage, load the skills in its row that apply to this job, also when the work resumes there.\n\n| Stage | Gate | Skills |\n|---|---|---|\n| 1. What to make, and from what | ASK | — |\n| 2. The user's files, as URLs | — | — |\n| 3. The model and its settings | ASK | film-shot-generation, sd2-pe, sd25-pe |\n| 4. The quote | SPEND | — |\n| 5. Run it | — | film-shot-generation |\n| 6. Show it | SHOW | — |\n\nA question that makes nothing (which models there are, a model's settings, a price, the balance, a\nDrive folder) skips the stages: answer it as **Questions that make nothing** says, and charge\nnothing.\n\n## 1. What to make, and from what\n\nRead the request before you ask (picsart-video-rules's Asking). Most say all of it: the medium, the\nsubject, and any picture or clip to start from. Say back what follows from it in one line (\"a 9:16\nimage for a story\"). 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) only for what is open and changes the result: the medium when it is not\nsaid, the frame when the destination does not set it, a voice or a song when \"audio\" is not said.\n\nAn edit names its tool by what it does to the picture:\n\n| The user wants | Tool | Its input |\n|---|---|---|\n| The background removed, the subject cut out | `picsart_image_remove_bg` | `image` |\n| The background replaced (\"put it on a beach\") | `picsart_image_change_bg` | `image`, and `prompt` for the new background |\n| Sharper, cleaner or bigger (\"make it 4k\") | `picsart_image_enhance` | `image`, and `scaleFactor` when they gave one |\n| A vector, an SVG | `picsart_image_vectorize` | `image` |\n\nEach picks its own model. Before a vector of a photo, say once that photos vectorize poorly and\nlogos, icons and simple graphics well. Anything else is made with `picsart_generate`.\n\n## 2. The user's files, as URLs\n\nEvery input is a URL: `image` on the edit tools, `imageUrls` and `videoUrl` on `picsart_generate`.\nA URL a Picsart tool returned in this conversation is passed as it is (picsart-video-rules's Asset URLs).\nOtherwise:\n\n- **A file on disk, and you can run shell commands:** call `picsart_upload_local_files` with each\n file's `name` and `bytes`, run each command it returns with the path in place of `{path}`, and\n read the URL from what the command prints, where the tool's description says it is. The copy is\n temporary: to keep the file, save it with `picsart_drive_upload` (`url`, `name`).\n- **A file you cannot reach:** call `picsart_drive_upload_ask` and end the turn. The URL arrives with\n the user's next message.\n- **An attachment the host hands you as a file object** (`download_url`, `file_id`): pass it as\n `file` to `picsart_drive_upload`, and use the `url` in its result.\n- **A file in their Picsart Drive:** find it as **Their Drive** says, and use its `url`, never its\n `downloadUrl`.\n\nUpload a file once, and reuse its URL for the rest of the conversation. Never pass a local path to\na tool: when one is refused (`local_source_not_supported`, \"Only https:// URLs or data: URIs\"),\nget a URL as above and call again.\n\n## 3. The model and its settings\n\nAn edit skips this stage. For `picsart_generate`:\n\n1. **The model.** When the user named one, use it. When they want to pick,\n ASK with `picsart_model_choose` where the host draws it, otherwise in text as the host notes\n say: three candidates from `picsart_model_catalog` (`concise: false`), each with what it is best\n for here, one marked recommended. When they want to look through all of them, open\n `picsart_model_show` with the `mode` and `purpose: \"generate\"`. Otherwise choose it yourself:\n - an image: `gpt-image-2.6-flare` (`flux-2-pro` for a 21:9 or 9:21 frame, which it does not\n hold). It takes `reasoningEffort`, not `quality`, and no `negativePrompt`;\n - anything else: `picsart_model_catalog` with the `mode`, `purpose: \"generate\"`, the\n `inputType` (`t2v` or `i2v` for a video, `tts` for a voice line, `sfx` for a sound, `music`\n for a song) and `acceptsImage` or `acceptsVideo` when the user brought one. Take the first\n row that holds the frame, the length and the inputs the request needs.\n\n Never name the model to the user unless they asked about models (picsart-video-rules's Tools).\n2. **Its settings.** For anything beyond `prompt`, read `picsart_model_params` for that model,\n and set only the settings it lists, with values it allows. A model's own settings, such as a\n start frame or a voice, go in `extra`. Correct a value whose meaning is clear without asking\n (`\"1920x1080\"` is `aspectRatio: \"16:9\"`); 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) when two readings give different results.\n Never take a setting from a model with a similar name. A start or end frame goes first in\n `imageUrls`, and the prompt names it: \"IMAGE 1 - START FRAME\". On a Seedance model (`seedance-…`), read\n the film-shot-generation skill's Seedance reference first: it says when a frame may use the\n model's own start frame field instead, and how its edit and extend prompts are written. Then\n write the prompt with the `sd25-pe` skill (Seedance 2.5) or `sd2-pe` (Seedance 2.0).\n3. **A video** is drafted and prompted as picsart-video-rules's SPEND says (rules 5, 8 and 9): its key\n frames first, as stills, and every prompt compiled and verified, as the film-shot-generation skill says\n under Key frames and Compile and verify.\n\n## 4. The quote\n\nEvery generation and every edit charges credits. Quote it, 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), as picsart-video-rules's SPEND\nsays. `picsart_preflight` takes the model and the planned `picsart_generate` inputs as `params`,\n`prompt` included: it checks them against the model and estimates the price. Fix everything it\nreports before you quote. `credits: null` means the price is not known, never that it is free. The\nedit tools give no quote of their own: to price one, preflight the model id you will pass as its\n`model` (the default may pick a different model). If that gives no number, say it charges credits\nand the amount is not known in advance.\n\nWhen the balance from `picsart_credits` is short of the quote, say by how much, and offer what\ncosts less: fewer outputs (`count`), a lower resolution or a shorter length, or a cheaper model.\nWhen the result carries a link to top up, give it exactly as returned.\n\n## 5. Run it\n\n- Several outputs of one prompt are `count` on one call; several different prompts on one model\n are `items` on one call (picsart-video-rules's SPEND, rule 4). Never loop calls: each call draws its own\n progress card.\n- A generation answers with a job. Follow it with `picsart_job_status`, passing the job and the\n `model`, and wait on it as picsart-video-rules's Tools says. With `count` or `items` the top-level `job` is only the first: pass\n each handle in `jobs` (an `items` entry's are in its own `jobs`) as `job`, one call each. Where\n the host draws widgets, the generation's card follows its jobs and posts the results back, so\n never ask the user to wait. Never send a generation again because it seems slow or the host\n timed out: it has usually finished and charged. Check the job, and for an `async: false` call\n look in their Drive first.\n- A result belongs to their Drive only when it says so (`drive`). With `folderUid`, a sync result\n is filed there before it returns (`drive.uid`); save an async one there with\n `picsart_drive_upload` once it completes.\n\n## 6. Show it\n\nSHOW each result, with one line on what it is: what was made, not how. Then offer one next step in\na sentence (another take, a different frame, an edit), and do it only on a yes.\n\n## Questions that make nothing\n\nAll of these are free. Answer in a few lines; never paste a whole list or table.\n\n- **Which models there are:** open `picsart_model_show` with the `mode` they asked about, so they\n can look through them. When you only need the list yourself, read `picsart_model_catalog`\n instead.\n- **What a model can do:** read `picsart_model_params` and say the gist: what it takes and its\n limits.\n- **What something would cost:** `picsart_preflight` for the price, `picsart_credits` for the\n balance. Give both, and make nothing until they say yes (stage 4).\n- **Their balance:** `picsart_credits`. Give it exactly as returned.\n- **Their Drive:** `picsart_drive_list` with no `folderUid` lists the top level. To open a folder,\n read its `uid` from `folders` in that result and pass it as `folderUid`, with `type` to keep one\n kind of file: `folderUid` takes a uid, never a folder name.\n\n## When a call fails\n\n- **Not enough credits:** read `picsart_credits`, give the balance and what the call needed, and\n offer what costs less (stage 4). Never call it again until the user says they are ready.\n- **Not signed in:** making and editing need a signed-in Picsart account. Say so in one line and\n stop; the host asks them to sign in. Never retry.\n- **A setting refused** (\"Invalid parameter\", \"Unsupported value\", a length past the model's\n limit): read `picsart_model_params`, correct the value, and quote again if the price changed.\n Never send the same settings again.\n- **The model is not found:** find its id with `picsart_model_catalog` (`provider` with the part of\n the name you have), then call again with the id it lists.\n- **A local path or a file refused:** get a URL (stage 2), then call again.\n- **The model is busy or the service errors:** say it is busy right now, and offer to try again\n in a moment or with another model. Never loop the retry yourself.\n- **A link from earlier stopped working:** find the file in their Drive (`picsart_drive_list`),\n or offer to make it again.\n""---\nname: generate-media\ndescription: Make an image, a video, a voice line, a sound or a song from a prompt, or edit a picture or product photo - remove or replace its background, enhance or upscale it, or turn it into a vector - with a model that fits, its settings checked and its price quoted before anything is charged. Also answers questions about models, prices, credits and Drive. Use when the user asks to generate, make or create an image, a video or audio, to edit a picture, to browse the models, or about a price, their credits or their Drive files. Load it first, before any tool, when they say not to ask, to work unattended, or set a spend limit. Load it before calling any Picsart model, generation or image tool.\nmetadata:\n uses: film-shot-generation, sd25-pe, sd2-pe\n title: Generate media\n short-description: Make or edit images, video, voice, sound and music\n argument-hint: '[what to make or edit]'\n starter-prompt: Make an image, a video or audio from my prompt.\n---\n\n# Make or edit an image, a video or audio\n\nRead picsart-video-rules first. One job: the user asks for one piece of media, or one edit of a picture,\nand gets it with no failed call and no surprise charge. A whole video project is another use case:\nwhen the user wants their footage cut, a screen recording turned into a video, a film or an\nanimated design, start that use case instead.\n\nBefore acting on a stage, load the skills in its row that apply to this job, also when the work resumes there.\n\n| Stage | Gate | Skills |\n|---|---|---|\n| 1. What to make, and from what | ASK | — |\n| 2. The user's files, as URLs | — | — |\n| 3. The model and its settings | ASK | film-shot-generation, sd2-pe, sd25-pe |\n| 4. The quote | SPEND | — |\n| 5. Run it | — | film-shot-generation |\n| 6. Show it | SHOW | — |\n\nA question that makes nothing (which models there are, a model's settings, a price, the balance, a\nDrive folder) skips the stages: answer it as **Questions that make nothing** says, and charge\nnothing.\n\n## 1. What to make, and from what\n\nRead the request before you ask (picsart-video-rules's Asking). Most say all of it: the medium, the\nsubject, and any picture or clip to start from. Say back what follows from it in one line (\"a 9:16\nimage for a story\"). 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) only for what is open and changes the result: the medium when it is not\nsaid, the frame when the destination does not set it, a voice or a song when \"audio\" is not said.\n\nAn edit names its tool by what it does to the picture:\n\n| The user wants | Tool | Its input |\n|---|---|---|\n| The background removed, the subject cut out | `picsart_image_remove_bg` | `image` |\n| The background replaced (\"put it on a beach\") | `picsart_image_change_bg` | `image`, and `prompt` for the new background |\n| Sharper, cleaner or bigger (\"make it 4k\") | `picsart_image_enhance` | `image`, and `scaleFactor` when they gave one |\n| A vector, an SVG | `picsart_image_vectorize` | `image` |\n\nEach picks its own model. Before a vector of a photo, say once that photos vectorize poorly and\nlogos, icons and simple graphics well. Anything else is made with `picsart_generate`.\n\n## 2. The user's files, as URLs\n\nEvery input is a URL: `image` on the edit tools, `imageUrls` and `videoUrl` on `picsart_generate`.\nA URL a Picsart tool returned in this conversation is passed as it is, except a HEIC photo's (picsart-video-rules's Asset URLs).\nOtherwise:\n\n- **A file on disk, and you can run shell commands:** call `picsart_upload_local_files` with each\n file's `name` and `bytes`, run each command it returns with the path in place of `{path}`, and\n read the URL from what the command prints, where the tool's description says it is. The copy is\n temporary: to keep the file, save it with `picsart_drive_upload` (`url`, `name`).\n- **A file you cannot reach:** call `picsart_drive_upload_ask` and end the turn. The URL arrives with\n the user's next message.\n- **An attachment the host hands you as a file object** (`download_url`, `file_id`): pass it as\n `file` to `picsart_drive_upload`, and use the `url` in its result.\n- **A file in their Picsart Drive:** find it as **Their Drive** says, and use its `url`, never its\n `downloadUrl`.\n\nUpload a file once, and reuse its URL for the rest of the conversation. Never pass a local path to\na tool: when one is refused (`local_source_not_supported`, \"Only https:// URLs or data: URIs\"),\nget a URL as above and call again.\n\n## 3. The model and its settings\n\nAn edit skips this stage. For `picsart_generate`:\n\n1. **The model.** When the user named one, use it. When they want to pick,\n ASK with `picsart_model_choose` where the host draws it, otherwise in text as the host notes\n say: three candidates from `picsart_model_catalog` (`concise: false`), each with what it is best\n for here, one marked recommended. When they want to look through all of them, open\n `picsart_model_show` with the `mode` and `purpose: \"generate\"`. Otherwise choose it yourself:\n - an image: `gpt-image-2.6-sunburst`, as picsart-video-rules's Image generation and supplied\n photos says. Use a supported generation ratio and frame/crop to a wider canvas; never\n silently switch models. Its `quality` is `max`, `xhigh`, `high`, `medium` or `low`,\n `complexity` is `high`, `medium` or `low`, and `resolution` is `1K`, `2K` or `4K`.\n It takes up to 16 `imageUrls` and ratios `1:1`, `3:2`, `2:3`, `16:9`, `9:16`, `4:3`,\n `3:4` and `auto`. Recheck the live schema; send neither `reasoningEffort` nor `negativePrompt`;\n - anything else: `picsart_model_catalog` with the `mode`, `purpose: \"generate\"`, the\n `inputType` (`t2v` or `i2v` for a video, `tts` for a voice line, `sfx` for a sound, `music`\n for a song) and `acceptsImage` or `acceptsVideo` when the user brought one. Take the first\n row that holds the frame, the length and the inputs the request needs.\n\n Never name the model to the user unless they asked about models (picsart-video-rules's Tools).\n2. **Its settings.** For anything beyond `prompt`, read `picsart_model_params` for that model,\n and set only the settings it lists, with values it allows. A model's own settings, such as a\n start frame or a voice, go in `extra`. Correct a value whose meaning is clear without asking\n (`\"1920x1080\"` is `aspectRatio: \"16:9\"`); 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) when two readings give different results.\n Never take a setting from a model with a similar name. A start or end frame goes first in\n `imageUrls`, and the prompt names it: \"IMAGE 1 - START FRAME\". On a Seedance model (`seedance-…`), read\n the film-shot-generation skill's Seedance reference first: it says when a frame may use the\n model's own start frame field instead, and how its edit and extend prompts are written. Then\n write the prompt with the `sd25-pe` skill (Seedance 2.5) or `sd2-pe` (Seedance 2.0).\n3. **A video** is drafted and prompted as picsart-video-rules's SPEND says (rules 5, 8 and 9): its key\n frames first, as stills, and every prompt compiled and verified, as the film-shot-generation skill says\n under Key frames and Compile and verify.\n\n## 4. The quote\n\nEvery generation and every edit charges credits. Quote it, 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), as picsart-video-rules's SPEND\nsays. `picsart_preflight` takes the model and the planned `picsart_generate` inputs as `params`,\n`prompt` included: it checks them against the model and estimates the price. Fix everything it\nreports before you quote. `credits: null` means the price is not known, never that it is free. The\nedit tools give no quote of their own: to price one, preflight the model id you will pass as its\n`model` (the default may pick a different model). If that gives no number, say it charges credits\nand the amount is not known in advance.\n\nWhen the balance from `picsart_credits` is short of the quote, say by how much, and offer what\ncosts less: fewer outputs (`count`), a lower resolution or a shorter length, or a cheaper model.\nWhen the result carries a link to top up, give it exactly as returned.\n\n## 5. Run it\n\n- Several outputs of one prompt are `count` on one call; several different prompts on one model\n are `items` on one call (picsart-video-rules's SPEND, rule 4). Never loop calls: each call draws its own\n progress card.\n- A generation answers with a job. Follow it with `picsart_job_status`, passing the job and the\n `model`, and wait on it as picsart-video-rules's Tools says. With `count` or `items` the top-level `job` is only the first: pass\n each handle in `jobs` (an `items` entry's are in its own `jobs`) as `job`, one call each. Where\n the host draws widgets, the generation's card follows its jobs and posts the results back, so\n never ask the user to wait. Never send a generation again because it seems slow or the host\n timed out: it has usually finished and charged. Check the job, and for an `async: false` call\n look in their Drive first.\n- A result belongs to their Drive only when it says so (`drive`). With `folderUid`, a sync result\n is filed there before it returns (`drive.uid`); save an async one there with\n `picsart_drive_upload` once it completes.\n\n## 6. Show it\n\nSHOW each result, with one line on what it is: what was made, not how. Then offer one next step in\na sentence (another take, a different frame, an edit), and do it only on a yes.\n\n## Questions that make nothing\n\nAll of these are free. Answer in a few lines; never paste a whole list or table.\n\n- **Which models there are:** open `picsart_model_show` with the `mode` they asked about, so they\n can look through them. When you only need the list yourself, read `picsart_model_catalog`\n instead.\n- **What a model can do:** read `picsart_model_params` and say the gist: what it takes and its\n limits.\n- **What something would cost:** `picsart_preflight` for the price, `picsart_credits` for the\n balance. Give both, and make nothing until they say yes (stage 4).\n- **Their balance:** `picsart_credits`. Give it exactly as returned.\n- **Their Drive:** `picsart_drive_list` with no `folderUid` lists the top level. To open a folder,\n read its `uid` from `folders` in that result and pass it as `folderUid`, with `type` to keep one\n kind of file: `folderUid` takes a uid, never a folder name.\n\n## When a call fails\n\n- **Not enough credits:** read `picsart_credits`, give the balance and what the call needed, and\n offer what costs less (stage 4). Never call it again until the user says they are ready.\n- **Not signed in:** making and editing need a signed-in Picsart account. Say so in one line and\n stop; the host asks them to sign in. Never retry.\n- **A setting refused** (\"Invalid parameter\", \"Unsupported value\", a length past the model's\n limit): read `picsart_model_params`, correct the value, and quote again if the price changed.\n Never send the same settings again.\n- **The model is not found:** find its id with `picsart_model_catalog` (`provider` with the part of\n the name you have), then call again with the id it lists.\n- **A local path or a file refused:** get a URL (stage 2), then call again.\n- **The model is busy or the service errors:** say it is busy right now, and offer to try again\n in a moment or with another model. Never loop the retry yourself.\n- **A link from earlier stopped working:** find the file in their Drive (`picsart_drive_list`),\n or offer to make it again.\n"Full snapshot data
{
"description": "Make an image, a video, a voice line, a sound or a song from a prompt, or edit a picture or product photo - remove or replace its background, enhance or upscale it, or turn it into a vector - with a model that fits, its settings checked and its price quoted before anything is charged. Also answers questions about models, prices, credits and Drive. Use when the user asks to generate, make or create an image, a video or audio, to edit a picture, to browse the models, or about a price, their credits or their Drive files. Load it first, before any tool, when they say not to ask, to work unattended, or set a spend limit. Load it before calling any Picsart model, generation or image tool.",
"included_files": [
{
"relative_path": "agents/openai.yaml",
"size_in_bytes": 186
}
],
"name": "generate-media",
"skill_md_contents": "---\nname: generate-media\ndescription: Make an image, a video, a voice line, a sound or a song from a prompt, or edit a picture or product photo - remove or replace its background, enhance or upscale it, or turn it into a vector - with a model that fits, its settings checked and its price quoted before anything is charged. Also answers questions about models, prices, credits and Drive. Use when the user asks to generate, make or create an image, a video or audio, to edit a picture, to browse the models, or about a price, their credits or their Drive files. Load it first, before any tool, when they say not to ask, to work unattended, or set a spend limit. Load it before calling any Picsart model, generation or image tool.\nmetadata:\n uses: film-shot-generation, sd25-pe, sd2-pe\n title: Generate media\n short-description: Make or edit images, video, voice, sound and music\n argument-hint: '[what to make or edit]'\n starter-prompt: Make an image, a video or audio from my prompt.\n---\n\n# Make or edit an image, a video or audio\n\nRead picsart-video-rules first. One job: the user asks for one piece of media, or one edit of a picture,\nand gets it with no failed call and no surprise charge. A whole video project is another use case:\nwhen the user wants their footage cut, a screen recording turned into a video, a film or an\nanimated design, start that use case instead.\n\nBefore acting on a stage, load the skills in its row that apply to this job, also when the work resumes there.\n\n| Stage | Gate | Skills |\n|---|---|---|\n| 1. What to make, and from what | ASK | — |\n| 2. The user's files, as URLs | — | — |\n| 3. The model and its settings | ASK | film-shot-generation, sd2-pe, sd25-pe |\n| 4. The quote | SPEND | — |\n| 5. Run it | — | film-shot-generation |\n| 6. Show it | SHOW | — |\n\nA question that makes nothing (which models there are, a model's settings, a price, the balance, a\nDrive folder) skips the stages: answer it as **Questions that make nothing** says, and charge\nnothing.\n\n## 1. What to make, and from what\n\nRead the request before you ask (picsart-video-rules's Asking). Most say all of it: the medium, the\nsubject, and any picture or clip to start from. Say back what follows from it in one line (\"a 9:16\nimage for a story\"). 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) only for what is open and changes the result: the medium when it is not\nsaid, the frame when the destination does not set it, a voice or a song when \"audio\" is not said.\n\nAn edit names its tool by what it does to the picture:\n\n| The user wants | Tool | Its input |\n|---|---|---|\n| The background removed, the subject cut out | `picsart_image_remove_bg` | `image` |\n| The background replaced (\"put it on a beach\") | `picsart_image_change_bg` | `image`, and `prompt` for the new background |\n| Sharper, cleaner or bigger (\"make it 4k\") | `picsart_image_enhance` | `image`, and `scaleFactor` when they gave one |\n| A vector, an SVG | `picsart_image_vectorize` | `image` |\n\nEach picks its own model. Before a vector of a photo, say once that photos vectorize poorly and\nlogos, icons and simple graphics well. Anything else is made with `picsart_generate`.\n\n## 2. The user's files, as URLs\n\nEvery input is a URL: `image` on the edit tools, `imageUrls` and `videoUrl` on `picsart_generate`.\nA URL a Picsart tool returned in this conversation is passed as it is, except a HEIC photo's (picsart-video-rules's Asset URLs).\nOtherwise:\n\n- **A file on disk, and you can run shell commands:** call `picsart_upload_local_files` with each\n file's `name` and `bytes`, run each command it returns with the path in place of `{path}`, and\n read the URL from what the command prints, where the tool's description says it is. The copy is\n temporary: to keep the file, save it with `picsart_drive_upload` (`url`, `name`).\n- **A file you cannot reach:** call `picsart_drive_upload_ask` and end the turn. The URL arrives with\n the user's next message.\n- **An attachment the host hands you as a file object** (`download_url`, `file_id`): pass it as\n `file` to `picsart_drive_upload`, and use the `url` in its result.\n- **A file in their Picsart Drive:** find it as **Their Drive** says, and use its `url`, never its\n `downloadUrl`.\n\nUpload a file once, and reuse its URL for the rest of the conversation. Never pass a local path to\na tool: when one is refused (`local_source_not_supported`, \"Only https:// URLs or data: URIs\"),\nget a URL as above and call again.\n\n## 3. The model and its settings\n\nAn edit skips this stage. For `picsart_generate`:\n\n1. **The model.** When the user named one, use it. When they want to pick,\n ASK with `picsart_model_choose` where the host draws it, otherwise in text as the host notes\n say: three candidates from `picsart_model_catalog` (`concise: false`), each with what it is best\n for here, one marked recommended. When they want to look through all of them, open\n `picsart_model_show` with the `mode` and `purpose: \"generate\"`. Otherwise choose it yourself:\n - an image: `gpt-image-2.6-sunburst`, as picsart-video-rules's Image generation and supplied\n photos says. Use a supported generation ratio and frame/crop to a wider canvas; never\n silently switch models. Its `quality` is `max`, `xhigh`, `high`, `medium` or `low`,\n `complexity` is `high`, `medium` or `low`, and `resolution` is `1K`, `2K` or `4K`.\n It takes up to 16 `imageUrls` and ratios `1:1`, `3:2`, `2:3`, `16:9`, `9:16`, `4:3`,\n `3:4` and `auto`. Recheck the live schema; send neither `reasoningEffort` nor `negativePrompt`;\n - anything else: `picsart_model_catalog` with the `mode`, `purpose: \"generate\"`, the\n `inputType` (`t2v` or `i2v` for a video, `tts` for a voice line, `sfx` for a sound, `music`\n for a song) and `acceptsImage` or `acceptsVideo` when the user brought one. Take the first\n row that holds the frame, the length and the inputs the request needs.\n\n Never name the model to the user unless they asked about models (picsart-video-rules's Tools).\n2. **Its settings.** For anything beyond `prompt`, read `picsart_model_params` for that model,\n and set only the settings it lists, with values it allows. A model's own settings, such as a\n start frame or a voice, go in `extra`. Correct a value whose meaning is clear without asking\n (`\"1920x1080\"` is `aspectRatio: \"16:9\"`); 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) when two readings give different results.\n Never take a setting from a model with a similar name. A start or end frame goes first in\n `imageUrls`, and the prompt names it: \"IMAGE 1 - START FRAME\". On a Seedance model (`seedance-…`), read\n the film-shot-generation skill's Seedance reference first: it says when a frame may use the\n model's own start frame field instead, and how its edit and extend prompts are written. Then\n write the prompt with the `sd25-pe` skill (Seedance 2.5) or `sd2-pe` (Seedance 2.0).\n3. **A video** is drafted and prompted as picsart-video-rules's SPEND says (rules 5, 8 and 9): its key\n frames first, as stills, and every prompt compiled and verified, as the film-shot-generation skill says\n under Key frames and Compile and verify.\n\n## 4. The quote\n\nEvery generation and every edit charges credits. Quote it, 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), as picsart-video-rules's SPEND\nsays. `picsart_preflight` takes the model and the planned `picsart_generate` inputs as `params`,\n`prompt` included: it checks them against the model and estimates the price. Fix everything it\nreports before you quote. `credits: null` means the price is not known, never that it is free. The\nedit tools give no quote of their own: to price one, preflight the model id you will pass as its\n`model` (the default may pick a different model). If that gives no number, say it charges credits\nand the amount is not known in advance.\n\nWhen the balance from `picsart_credits` is short of the quote, say by how much, and offer what\ncosts less: fewer outputs (`count`), a lower resolution or a shorter length, or a cheaper model.\nWhen the result carries a link to top up, give it exactly as returned.\n\n## 5. Run it\n\n- Several outputs of one prompt are `count` on one call; several different prompts on one model\n are `items` on one call (picsart-video-rules's SPEND, rule 4). Never loop calls: each call draws its own\n progress card.\n- A generation answers with a job. Follow it with `picsart_job_status`, passing the job and the\n `model`, and wait on it as picsart-video-rules's Tools says. With `count` or `items` the top-level `job` is only the first: pass\n each handle in `jobs` (an `items` entry's are in its own `jobs`) as `job`, one call each. Where\n the host draws widgets, the generation's card follows its jobs and posts the results back, so\n never ask the user to wait. Never send a generation again because it seems slow or the host\n timed out: it has usually finished and charged. Check the job, and for an `async: false` call\n look in their Drive first.\n- A result belongs to their Drive only when it says so (`drive`). With `folderUid`, a sync result\n is filed there before it returns (`drive.uid`); save an async one there with\n `picsart_drive_upload` once it completes.\n\n## 6. Show it\n\nSHOW each result, with one line on what it is: what was made, not how. Then offer one next step in\na sentence (another take, a different frame, an edit), and do it only on a yes.\n\n## Questions that make nothing\n\nAll of these are free. Answer in a few lines; never paste a whole list or table.\n\n- **Which models there are:** open `picsart_model_show` with the `mode` they asked about, so they\n can look through them. When you only need the list yourself, read `picsart_model_catalog`\n instead.\n- **What a model can do:** read `picsart_model_params` and say the gist: what it takes and its\n limits.\n- **What something would cost:** `picsart_preflight` for the price, `picsart_credits` for the\n balance. Give both, and make nothing until they say yes (stage 4).\n- **Their balance:** `picsart_credits`. Give it exactly as returned.\n- **Their Drive:** `picsart_drive_list` with no `folderUid` lists the top level. To open a folder,\n read its `uid` from `folders` in that result and pass it as `folderUid`, with `type` to keep one\n kind of file: `folderUid` takes a uid, never a folder name.\n\n## When a call fails\n\n- **Not enough credits:** read `picsart_credits`, give the balance and what the call needed, and\n offer what costs less (stage 4). Never call it again until the user says they are ready.\n- **Not signed in:** making and editing need a signed-in Picsart account. Say so in one line and\n stop; the host asks them to sign in. Never retry.\n- **A setting refused** (\"Invalid parameter\", \"Unsupported value\", a length past the model's\n limit): read `picsart_model_params`, correct the value, and quote again if the price changed.\n Never send the same settings again.\n- **The model is not found:** find its id with `picsart_model_catalog` (`provider` with the part of\n the name you have), then call again with the id it lists.\n- **A local path or a file refused:** get a URL (stage 2), then call again.\n- **The model is busy or the service errors:** say it is busy right now, and offer to try again\n in a moment or with another model. Never loop the retry yourself.\n- **A link from earlier stopped working:** find the file in their Drive (`picsart_drive_list`),\n or offer to make it again.\n"
}SHA-256 of public snapshot: 425f498ba1be843f1637f2e89def4a337791b6a90b791c49d2dec86c4f8423f1