{"id":13520,"plugin_id":"plugin_asdk_app_6a994cc6cb54819188bb2204632c7f89","kind":"skill","collection_source":null,"comparison_source":null,"observed_at":"2026-09-30T23:07:38.940Z","digest":"243c23b9177961d9fc3f060d58b15e8748c7a5279b5be53c64951420b7c3998b","against":null,"payload":{"description":"Organize existing Heyzine flipbooks in bookshelf collections. Use when users ask to list shelves, inspect contents, add, remove, or position flipbooks, update a social preview, or ask about bookshelf creation and ordering limits.","included_files":[{"relative_path":"agents/openai.yaml","size_in_bytes":384}],"name":"bookshelf-collections","skill_md_contents":"---\nname: bookshelf-collections\ndescription: Organize existing Heyzine flipbooks in bookshelf collections. Use when users ask to list shelves, inspect contents, add, remove, or position flipbooks, update a social preview, or ask about bookshelf creation and ordering limits.\n---\n\n# Heyzine bookshelf collections\n\nA bookshelf references existing flipbooks. Adding or removing membership does\nnot copy or delete the flipbook.\n\n## Inputs and boundaries\n\n- Identify a bookshelf and flipbook by id, public URL, short id, or an\n  unambiguous title returned by the list tools.\n- In membership tools, `id` is the bookshelf and `flipbook_id` is the\n  flipbook. Never transpose them.\n- There is no tool to create, delete, or reorder an existing bookshelf. Explain\n  that those actions require the Heyzine bookshelf editor.\n- If bookshelves are unavailable for the account, report the server's plan\n  error. Do not invent a substitute collection.\n\n## Resolve names\n\n1. Call `heyzine_list_bookshelves` to resolve a shelf title.\n2. Call `heyzine_list_flipbooks` to resolve a flipbook title.\n3. Proceed on one clear match. If several entries plausibly match, show their\n   titles, ids, and URLs and ask the user to choose. If none match, report that\n   and stop.\n\nDo not rely on a remembered list when the user asks about current membership.\n\n## Inspect a bookshelf\n\nCall `heyzine_list_bookshelf_flipbooks` with the bookshelf `id`. Preserve the\nreturned display order and positions when answering what visitors see.\n\n## Add flipbooks\n\nCall `heyzine_add_to_bookshelf` once for each flipbook with `id` and\n`flipbook_id`. Pass optional `position` only when the user specifies placement;\nit is zero-based. A flipbook may belong to several shelves.\n\nFor a batch request, list and resolve the matching flipbooks first. Add only\nclear matches, then report the added count and any skipped or failed items.\n\n## Remove flipbooks\n\nCall `heyzine_remove_from_bookshelf` with the shelf `id` and `flipbook_id`. This\nremoves only the membership. If \"remove\" or \"delete\" could mean deleting the\nflipbook itself, clarify before acting. Never call `heyzine_delete_flipbook`\nfor an unqualified shelf change.\n\n## Update the social preview\n\n`heyzine_set_bookshelf_social` controls how the shelf's link renders when\nshared. Pass `id` plus only the requested `title`, `description`, and\n`thumbnail` fields. `thumbnail` must be a public image URL. Do not invent\nmissing metadata.\n\n## Report the result\n\nAfter membership changes, list the shelf once to verify the current contents.\nReturn the bookshelf URL, the resulting count, and any failures. For a batch,\nsummarize counts instead of narrating every tool call.\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}