{"id":99326,"plugin_id":"plugin_asdk_app_6af20aca7d008191b1c8506b8f187772","kind":"skill","collection_source":"plugin_package","comparison_source":null,"observed_at":"2026-11-16T18:17:21.652Z","digest":"3d4946ce4b7b44186e7e9c1b92adb43002be31f345f6258bcfb7cecd8a13394c","against":null,"payload":{"description":"Schedule, publish, and manage images, videos, and carousels on the user's connected TikTok, Instagram, YouTube, LinkedIn, Facebook, or X accounts, plus text-only X posts. Use when the user wants to post, schedule, or share content, see what is scheduled, where a post went live, or how posts did, or reschedule, edit, cancel, publish now, or retry a post. NOT for making the asset (sceneform-generate) or reading brand identity (sceneform-brand).","included_files":[],"name":"sceneform-publish","skill_md_contents":"---\nname: sceneform-publish\ndescription: Schedule, publish, and manage images, videos, and carousels on the user's connected TikTok, Instagram, YouTube, LinkedIn, Facebook, or X accounts, plus text-only X posts. Use when the user wants to post, schedule, or share content, see what is scheduled, where a post went live, or how posts did, or reschedule, edit, cancel, publish now, or retry a post. NOT for making the asset (sceneform-generate) or reading brand identity (sceneform-brand).\nlicense: MIT\nmetadata:\n  author: sceneform\n  version: \"0.9.0\"\n---\n\n# Publish with Sceneform\n\n`schedule_post` sends one finished asset or carousel to one connected social\naccount, either as soon as possible or at a set time. Posts go out through\nthe user's own account and appear on the Schedule page in the Sceneform\ndashboard. The other tools here read the connected accounts and the\nSchedule, and change posts that are already on it. For a text-only X post,\nomit both media refs. X supports up to four images or one MP4 video (up to\n512 MB in Sceneform), with up to 280 weighted characters; links count as 23\ncharacters. The X account's audience settings apply. An X post can carry a\nfirst comment: a reply from the same account posted right after it goes\nlive, the usual place for a link, since X shows posts without one to more\npeople. X analytics and threads are not supported. Each X post costs\nSceneform credits, more when its text has a link, and a first comment is\npriced as a second post; the approval shows the exact cost. A post that\nfails before X receives it is refunded, and so is a first comment X\nrefuses.\n\n## Workflow\n\n1. Get the asset. Use an `asset_ref` from a finished operation\n   (`wait_operations` or `get_operation`, `status: \"succeeded\"`) or from\n   `search_library`. The asset must be complete; a pending output cannot be\n   scheduled. To post a whole carousel, pass its `carousel_ref` instead of\n   `asset_ref` once `get_carousel` reports it `ready`: every slide goes out\n   in order as one multi-image post. YouTube and Facebook take videos only,\n   and each other platform caps the slide count; `schedule_post` names the\n   limit when a carousel is too long. Skip this step for a text-only X post.\n2. Read the account. `list_social_accounts` gives, for each connected\n   account, `privacy_options` (who a post can be shown to: `public`,\n   `followers`, `friends`, `private`), the TikTok `interactions` it can turn\n   on (`comments`, `duet`, `stitch`), and for Facebook the `pages` it can\n   post to.\n3. Ask the user what only they decide. For TikTok, ask who can see the post\n   (one of its `privacy_options`) and whether to allow comments, and duet and\n   stitch for a video. TikTok requires the user's own choice: never pick a\n   privacy for them, and leave every interaction off unless they turn it on.\n   Ask once per conversation: when the user has already said, for example\n   \"public, comments on\", reuse that for their later TikTok posts and say so\n   with each quote, unless they change it. `private` makes a test post only\n   the user sees, on TikTok and YouTube.\n4. Write the caption in full, in the brand's voice (read the brand kit first\n   with sceneform-brand when there is one). Add a short `title` only for\n   platforms that show one, such as YouTube.\n   - The first line carries the hook: feeds cut the caption after a line or\n     two, so the reason to stop scrolling comes first.\n   - One idea, then one call to action (\"Link in bio\", \"Save this for\n     later\").\n   - Three to five specific hashtags at the end on TikTok and Instagram;\n     none or one or two on LinkedIn and Facebook.\n   - Facts, prices, and claims only from the user or the BrandKit.\n   - A paid partnership or a sponsored post says so in the caption.\n5. Quote. Call `schedule_post` with `asset_ref` or `carousel_ref`,\n   `platform` (`tiktok`, `instagram`, `youtube`, `linkedin`, `facebook`, `x`),\n   `caption`, `privacy` (required for TikTok; defaults to `public`\n   elsewhere), `interactions` and `ai_generated` for TikTok,\n   `facebook_page_id` when a Facebook account has several Pages,\n   `first_comment` for X when the post has a link to share, optional\n   `title`, and optional `scheduled_for` as an ISO 8601 datetime with the\n   user's timezone offset (`2026-09-10T09:00:00+02:00`), at most 30 days\n   ahead. Omit `scheduled_for` to publish as soon as possible. The tool\n   returns `status: \"awaiting_confirmation\"` with a `summary`, a\n   `consequence`, the `details` (platform, Page, who can see it, the slide\n   count for a carousel, when, title, and for TikTok the AI-generated label\n   and interactions), the caption as `body`, and an `action_ref`. A\n   `Daily limit` detail means the TikTok account is past TikTok's roughly 15\n   posts a day: say so, since TikTok may refuse the post. A carousel edited\n   after its quote is refused when confirmed; quote it again.\n6. Confirm. Posting always asks, even where generation does not. Show the\n   user the consequence, the details, and the caption, and only after they\n   say yes call `confirm_actions` with the `action_ref` in `action_refs`.\n   With `card_offered: true` the host was also given a card with Approve and\n   Skip buttons; say they can approve there. Its\n   `results[0].result` holds the `scheduled_post_ref`, the `platform`, and\n   `scheduled_for`.\n\n```sh\nsceneform accounts\nsceneform publish --asset ./out/1.mp4 --platform tiktok --caption \"New drop this Friday\" --privacy public --interactions comments --ai-generated yes --at 2026-11-06T09:00:00+01:00\nsceneform confirm 3f2a7c1e-5b4d-4e8a-9c6f-0d1e2f3a4b5c\n```\n\nWith `--yes` the CLI confirms on its own. `--asset` accepts a local path or\nan `asset_ref`; `--carousel <carousel_ref>` posts a whole carousel instead.\nFor text-only X: `sceneform publish --platform x --caption \"We shipped.\"`.\nAdd `--first-comment \"Notes at https://example.com\"` to reply with the link.\n\n## Manage posts\n\n- `list_social_accounts` lists each connected platform, whether it is\n  `connected` or `disconnected`, `can_post`, and the options in step 2. A\n  `disconnected` account is connected again on the Connections page.\n- `list_scheduled_posts` lists posts in a window (default: the last 7 days\n  through the next 30), filtered by `platform` or `statuses`. Each post has\n  its `scheduled_post_ref`, `status` (`scheduled`, `publishing`, `posted`,\n  `sent_as_draft`, `failed`, `cancelled`, `held`), time, caption,\n  `media_type`, `privacy`, the `asset_ref` or `carousel_ref` it published,\n  the `error` when it failed, and once posted its `post_url` (the live post\n  on the platform, when the platform gives a link) and `metrics` (views,\n  likes, comments). Use `statuses: [\"failed\"]` to find posts to retry.\n- `update_scheduled_post` moves a `scheduled` post to a new future time or\n  replaces its caption or title. Pass only what changes.\n- `cancel_scheduled_post` unschedules a `scheduled` or `held` post, or\n  dismisses a `failed` or `sent_as_draft` one, or a `publishing` one that\n  stalled. A post still publishing can't be cancelled, and a `posted` post\n  is live; the user deletes it on the platform.\n- `publish_scheduled_post_now` publishes a `scheduled` post now, or retries\n  a `failed` one or a `publishing` one that stalled. A failure whose `error`\n  says the post may already be live is refused: the user checks the\n  platform first. It returns once publishing starts; check the outcome\n  later with `list_scheduled_posts`.\n\n```sh\nsceneform posts --status failed\nsceneform post-edit k57f2a9c1d3e4b5f6a7b8c9d0e1f2a3b --at 2026-11-07T09:00:00+01:00 --caption \"New drop this Saturday\" --yes\nsceneform post-cancel k57f2a9c1d3e4b5f6a7b8c9d0e1f2a3b --yes\nsceneform post-now k57f2a9c1d3e4b5f6a7b8c9d0e1f2a3b --yes\n```\n\n## Rules\n\n- Never publish without an explicit yes on the exact summary. Do not infer\n  consent from an earlier message.\n- Ask for the timezone when the user names a time without one. Never guess it.\n- For TikTok, ask the user who can see the post and which interactions to\n  allow; never choose for them. Ask once and reuse their answer for later\n  posts in the conversation.\n- For TikTok, set `ai_generated` to whether AI made the asset: `true` for a\n  Sceneform output, `false` for the user's own photo or video unless they say\n  AI made it. Ask when you cannot tell. TikTok labels the post AI-generated\n  when it is `true` or omitted. Other platforms ignore it.\n- A platform with no connected account fails with a safe message. Point the\n  user to the `connections_url` from `list_social_accounts` (Settings,\n  Connections in the dashboard); there is no way to connect an account from\n  here.\n- Confirming the same `action_ref` twice is safe, and it is the way to retry\n  a confirmation that timed out or failed: `sceneform confirm <action_ref>`\n  in the CLI. Only when that answers `PLAN_STALE` (the post failed and was\n  not made) quote it again; otherwise calling `schedule_post` again creates\n  a second post once confirmed. To change a post, use `update_scheduled_post` instead of\n  scheduling it again.\n- Reschedule, edit, cancel, publish now, or retry a post only when the user\n  asked for that post. State a new time or caption back to them.\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}