Update to Heyzine Flipbooks

{
  "description": "Embed Heyzine flipbooks and manage social sharing metadata. Use when users ask for embed HTML, website or CMS placement, or link preview titles, descriptions, and thumbnails.",
  "included_files": [
    {
      "relative_path": "agents/openai.yaml",
      "size_in_bytes": 380
    }
  ],
  "name": "flipbook-embedding",
  "skill_md_contents": "---\nname: flipbook-embedding\ndescription: Embed Heyzine flipbooks and manage social sharing metadata. Use when users ask for embed HTML, website or CMS placement, or link preview titles, descriptions, and thumbnails.\n---\n\n# Embedding and sharing flipbooks\n\nKeep embedding and social previews as separate workflows. Do not change\npublication design or access settings unless the user asks.\n\n## Resolve the target\n\n- Accept a public flipbook URL directly.\n- If the user gives an id, short id, or title, use\n  `heyzine_flipbook_details` and `heyzine_list_flipbooks` as needed to get the\n  canonical URL.\n- If a title is ambiguous, list the candidates and ask which one. Never\n  assemble or guess a publication URL.\n\n## Return embed HTML\n\n1. Call `heyzine_oembed` with the canonical public URL. Pass `maxwidth` or\n   `maxheight` only when the user supplied a size constraint.\n2. Return the `html` field in a code block without changing its iframe\n   attributes.\n3. If oEmbed returns an error, report it and stop. Do not fabricate embed HTML.\n\nAccess protection remains active inside an embed. Do not disable protection to\nmake an embed unless the user explicitly requests that separate change.\n\nFor WordPress, first suggest pasting the canonical URL into an embed block; use\nthe returned HTML in a Custom HTML block if auto-embedding is unavailable. For\na CMS that strips iframes, return the public link instead. Ask which platform\nonly when its placement requirements affect the answer.\n\nIf the user asks for responsive behavior, wrap the unmodified iframe rather\nthan rewriting its attributes.\n\n## Update a social preview\n\nChoose the tool by publication type:\n\n- `heyzine_set_flipbook_social` for a flipbook.\n- `heyzine_set_bookshelf_social` for a bookshelf.\n\nResolve an ambiguous title with the matching list tool. Pass the publication\n`id` and only the fields the user wants to change:\n\n| Field | Requirement |\n| --- | --- |\n| `title` | Social card headline |\n| `description` | Social card description |\n| `thumbnail` | Publicly reachable image URL |\n\nDo not invent missing copy or a thumbnail URL. If the user asks to repair a\ncomplete card but provides only some fields, ask for the missing content. A\nlandscape image near 1200 by 630 pixels is a useful recommendation, not a\nrequirement.\n\nSocial networks cache previews. After a successful update, explain that an\nalready-shared URL may keep the old card until that network refreshes it.\n\n## Report the result\n\nFor embedding, lead with the exact HTML and the canonical URL. For social\nmetadata, state which fields changed and return the publication URL when it is\navailable.\n"
}