Update to PurrPlan Social Scheduler

{
  "description": "Use when someone first asks PurrPlan to plan, draft or schedule a social media post, so the right workspace and accounts are picked before anything is written.",
  "included_files": [],
  "name": "get-started-with-purrplan",
  "skill_md_contents": "---\nname: get-started-with-purrplan\ndescription: Use when someone first asks PurrPlan to plan, draft or schedule a social media post, so the right workspace and accounts are picked before anything is written.\n---\n\n# Getting started with PurrPlan\n\nPurrPlan acts on a **workspace**: a set of connected social accounts, its posts,\nits inbox and its figures. Almost every tool needs a workspace uuid, so the\nfirst two calls of a session are always the same.\n\n## Open a session\n\n1. Call `list_workspaces`. It returns the workspaces the signed-in account can\n   reach, each with its uuid.\n2. If there is more than one, ask which one to work in rather than guessing. A\n   post written into the wrong workspace goes to the wrong audience.\n3. Call `list_accounts` for that workspace. It returns the connected social\n   accounts and their networks. Only those can receive a post.\n\nIf `list_accounts` comes back empty, stop and say so: accounts are connected in\nPurrPlan itself, not from here, and there is nothing to publish to yet.\n\n## Write a post\n\n- Pick the accounts from `list_accounts`; never invent an account identifier.\n- Call `create_draft_post` with the text and the chosen accounts. Without\n  `scheduled_at` it stays a draft, which is the safe default.\n- Add `scheduled_at` (ISO 8601 UTC) only once the date and time have been\n  confirmed. Read the local timezone back to the person before scheduling, so a\n  post meant for 9am local does not leave at 9am UTC.\n- To attach media, call `upload_media_from_url` first and pass the returned\n  uuid.\n\nEach network has its own rules on length, number of images, threads and video\nformats. PurrPlan refuses a post that breaks them and says which rule was hit.\nShorten or split the content rather than retrying the same call.\n\n## Change your mind\n\n`update_draft_post` edits a post in place: there is no need to delete and\nrecreate it, and recreating would lose its history. The previous text is\nreplaced and not kept, so show what changes before applying it.\n\n`delete_post` only accepts drafts and scheduled posts. An already published\npost cannot be deleted from here.\n\n## Answer and measure\n\n- `list_inbox` reads the comments, mentions and private messages already\n  collected; `refresh_inbox` fetches the newest ones from the networks, and\n  `manage_inbox_messages` sorts them (read, archived, assigned).\n- Answering a message is **not** available here, by design: publishing a reply\n  under someone's name cannot be taken back, so that permission is never granted\n  to the assistant. Draft the wording if asked, and say it must be sent from\n  PurrPlan.\n- `get_analytics` and `get_top_posts` cover a period; `get_post_stats` covers\n  one publication. A post published minutes ago has no figures yet, and that is\n  not an error.\n"
}