Skip to content

PlutoLei/paperbanana-skill / plugins/paperbanana/skills/paperbanana

paperbanana

Verified

Generate and revise academic figures, data plots, or image slides through a configured PaperBanana backend; inspect their automated review status. Use for PaperBanana requests and academic image generation, not general presentation editing or code-only plotting.

PaperBanana

Translate a research brief into an image-generation task, then inspect both the output and its review. For a complete deck or native editable PowerPoint, use the separately installed paperbanana-slide-deck skill when available.

Establish the task

  1. Identify the requested output, input material, destination and existing run. For a review or plan-only request, return findings without creating files or calling generation tools. Reuse the user's approved choices.
  2. Preserve explicit and saved image-provider/model choices, including Gemini or Vertex configuration. The agent host does not select the image provider. If no choice exists, use the configured backend; ask only if an actual choice is missing. Historical examples do not establish a current model ranking.
  3. Locate the user-selected Python backend/environment. Check the relevant command's --help before using version-dependent flags. Do not scan another agent's private directories or read credentials into the conversation.
  4. Separate native PowerPoint editing from raster image generation. A screenshot or embedded SVG is not a native editable text box, table or chart.

Choose the command

IntentCommandRequired material
Method, architecture or workflow figuregenerateSource text/PDF and communicative intent
Statistical plotplotActual CSV/JSON data and plot intent
One image slideslideSlide prompt
Several image slidesslide-batchPrompt directory
Compare an image with a referenceevaluateBoth images, source context and caption
Dataset information/download/removaldataRequested operation; removal needs its own scope
Provider setupsetupA configuration request; use the host's credential workflow

See command examples for invocation patterns. Use the selected checkout's help as the CLI authority. Code-only plotting requests can use the host's plotting tools without an image-model call.

Image-provider flags use factory names such as google_imagen, openai_imagen, bedrock_imagen and openrouter_imagen. VLM flags use names such as gemini, openai and anthropic. Verify names against the installed version.

Generate or revise

  • Keep supplied labels, arrows, quantities and scientific meaning traceable to the input. Mark invented example data as illustrative. Do not repair missing research facts by making them up. For mixed-language figures, carry an explicit list of required labels into the prompt and check them in the returned image.
  • Write inline input into a task-owned text file when execution is authorized. Pass file paths as quoted arguments; do not interpolate user prose into shell commands. Keep the original input and references intact.
  • Use the authorized provider and iteration limits. Do not add paid optimization, a provider comparison, a large dataset download or an unbounded retry loop to a request that did not authorize it. Reuse existing authorization within scope.
  • For edits, identify the exact prior run/image and reference files first. Use that command's supported continuation/edit mechanism. If the backend lacks reference editing, explain the limitation before substituting regeneration.
  • For a single changed slide, regenerate that slide and reassemble the deck; preserve unrelated pages and source prompts. A failed batch does not authorize discarding successful pages or regenerating the entire deck.

Recover without changing the task

Observed resultNext action
Rate limit or temporary service errorUse the backend's bounded retry policy within the approved limit; report exhausted attempts
Authentication/configuration errorStop that call and report the required setup; do not print keys or try another account
Timeout with uncertain generation outcomeInspect the run and existing output before retrying, to avoid duplicate work/charges
Requested provider unavailableKeep the selection; present a concrete alternative only if a new choice is needed
Critic timeout, malformed output or unavailable reviewPreserve the image and mark it UNREVIEWED; never treat missing feedback as acceptance
Partial batchList successful/missing pages and resume only the missing or requested pages using supported commands

Do not switch providers merely because a fallback credential exists. A retry or fallback must preserve the user's routing and spending choices. Continuation flags are command-specific: generate --continue-run is not evidence that slide-batch --continue exists.

Inspect and deliver

Open the actual output when the host has an image viewer. Check requested labels, connections, numbers, cropping and legibility. If it cannot be inspected, say so. Report the artifact, run identifier when available, provider/model only as actually known, and review state separately. A successful API call, a Critic score and scientific acceptance are different claims.

When revisions are needed, identify the concrete defect and revise the affected input/run within scope. Do not repeatedly rerun generation without a new diagnosis. Keep failures and unreviewed pages visible in the final report.

canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill.Stars: 198kUpdated Claude CodeCodexVerifiedInstall