Read picsart-video-rules first. One job: in a turn or two, the user knows their account works, has their Picsart open if they want it, and knows what to ask for next. Nothing here charges credits.
If the user installed Picsart Video in the middle of a task, do stage 1, then go back to that task in the same conversation. Offer the rest in one line at the end instead.
| Stage | Gate | Skills |
|---|---|---|
| 1. The account and the credits | — | — |
| 2. Open Picsart, when the host has it | ASK | open-picsart-app |
| 3. What Picsart Video does | — | — |
| 4. Where to start | ASK | — |
1. The account and the credits
Call picsart_credits with {}.
- It answers: say in one line that the account is connected and give the balance as the tool returns it. Never round it, add it up or guess it.
- It says the user is not signed in: say that making and editing need a signed-in Picsart account, and that the host will ask them to sign in the first time a step needs it. Go on with stage 3, and skip stage 2 until they are signed in.
- It fails otherwise: say that the balance could not be read right now, and go on.
2. Open Picsart, when the host has it
Only when the open-picsart-app skill is among your skills: offer it as that skill says. Without it, skip this stage and say nothing about it: not every host can open Picsart beside the conversation.
3. What Picsart Video does
Say it in three short parts, in the user's words. The tools in brackets are for you, never for the user (picsart-video-rules's Tools).
- Drive. Their files, stored with their Picsart account: browse them, search them in
Picsart, make folders, move and delete (a deleted file goes to the trash first).
The
picsart_drive_*tools do this (picsart_drive_list,picsart_drive_create_folder,picsart_drive_move,picsart_drive_delete). When they bring a file of their own, it comes in withpicsart_drive_upload_ask. - Create. Images, videos and audio from a prompt, with a choice of models. They can pick a
model themselves (
picsart_model_show), and every creation is quoted before anything is charged (picsart_preflight, then picsart-video-rules's SPEND). - Edit. For an image: remove the background (
picsart_image_remove_bg), replace it (picsart_image_change_bg), enhance it (picsart_image_enhance) or turn it into a vector (picsart_image_vectorize). For a video: a scene editor where they watch it, trim, split and comment, and approve it before it is exported (picsart_scene_editor, picsart-video-rules's REVIEW).
Edits charge credits too; each is quoted first. Say that once, not per item.
4. Where to start
Offer the use cases in this package that fit the user, in their words. Name only use cases that are here: look at the skills you have, not at this list. Today they can include:
generate-media: one image, video, voice line, sound or song from a prompt, or one edit of a picture;make-screen-videos: a screen recording of an app or website becomes how-to shorts, a promo or a tutorial;animate-design: a design or the user's own images and clips become an animated ad or reel;movie-producer: a story becomes a short film with recurring characters, one look and several scenes;cut-footage-into-reel: the user's own footage of people talking becomes a tight vertical short, the best moments in order, with captions and music if they want them.
ASK with 2–4 of them, plus "Just explore". On a use case, start it by its name, from its first stage. On "Just explore", invite them to ask for anything from stage 3, and end the turn.