Prismer Workspace

Prismer Workspace Skill

Control Prismer.AI academic workspace components and execute research operations.

Tools

latex_compile

Compile LaTeX source code to PDF. Auto-switches UI to LaTeX editor and sends compile result.

Parameters:

• content (string, required): LaTeX source code to compile
• filename (string, optional): Output filename without extension (default: "document")
• engine (string, optional): "pdflatex" | "xelatex" | "lualatex" (default: "pdflatex")

Returns: PDF URL on success, error message on failure.

Example:

latex_compile content="\\documentclass{article}\\begin{document}Hello World\\end{document}"

jupyter_execute

Execute Python code in a Jupyter kernel. Auto-switches UI to Jupyter notebook and displays results.

Parameters:

• code (string, required): Python code to execute
• kernel (string, optional): Kernel name (default: "python3")

Returns: Execution outputs including stdout, stderr, and display data.

Example:

jupyter_execute code="import numpy as np\nprint(np.pi)"

jupyter_notebook

Create, read, update, delete, or list Jupyter notebooks.

Parameters:

• path (string, required): Path to the notebook or directory
• operation (string, required): "create" | "read" | "update" | "delete" | "list"
• content (object, optional): Notebook content for create/update operations

Example:

jupyter_notebook path="analysis.ipynb" operation="create" content={"cells": [...]}
jupyter_notebook path="/workspace" operation="list"

load_pdf

Load a PDF document in the workspace viewer. Auto-switches UI to PDF reader.

Parameters:

• source (string, required): URL or path to PDF file
• page (number, optional): Page number to navigate to (default: 1)

Example:

load_pdf source="/workspace/papers/paper.pdf" page=5

arxiv_to_prompt

Convert an arXiv paper to flattened LaTeX optimized for LLM reading. Downloads the paper source, strips comments, and outputs clean text.

Parameters:

• arxiv_id (string, required): arXiv paper ID (e.g., "2303.08774")
• remove_comments (boolean, optional): Remove LaTeX comments (default: true)
• remove_appendix (boolean, optional): Remove appendix sections (default: false)
• abstract_only (boolean, optional): Extract only the abstract
• list_sections (boolean, optional): List all section names
• figure_paths (boolean, optional): Only include figure file paths

Examples:

arxiv_to_prompt arxiv_id="2303.08774"
arxiv_to_prompt arxiv_id="2303.08774" abstract_only=true
arxiv_to_prompt arxiv_id="2303.08774" list_sections=true

switch_component

Switch the active workspace component.

Parameters:

• component (string, required): Target component name
  • "pdf-reader"
  • "latex-editor"
  • "jupyter-notebook"
  • "code-playground"
  • "ai-editor" (Notes editor)
  • "ag-grid"
  • "bento-gallery"
  • "three-viewer"

Example:

switch_component component="jupyter-notebook"

update_notes

Update the Notes editor (ai-editor) with HTML content. Auto-switches to Notes editor. Use for creating experiment templates, writing notes, or inserting structured content.

Parameters:

• content (string, required): HTML content to set in the editor

Example:

update_notes content="<h1>Experiment Notes</h1><h2>Objective</h2><p>Evaluate YOLOv8 on COCO 2017...</p>"

update_latex

Update the LaTeX editor with source code without compiling. Auto-switches to LaTeX editor. Use for creating or editing LaTeX documents before compilation.

Parameters:

• file (string, optional): Filename (default: "main.tex")
• content (string, required): LaTeX source code

Example:

update_latex content="\\documentclass[conference]{IEEEtran}\\begin{document}\\title{My Paper}\\end{document}"

update_notebook

Add or update cells in the Jupyter notebook without executing. Auto-switches to Jupyter notebook. Use for setting up notebook content.

Parameters:

• cells (array, required): Array of cells with {type: "code"|"markdown", source: string}
• execute (boolean, optional): Whether to execute code cells (default: false)

Example:

update_notebook cells=[{"type": "code", "source": "import numpy as np\nimport matplotlib.pyplot as plt"}] execute=false

send_ui_directive

Send a raw UI directive for advanced workspace control. Use the dedicated tools above when possible.

Parameters:

• type (string, required): Directive type
• payload (object, required): Directive payload

Supported directive types:

• SWITCH_COMPONENT - Switch active component
• UPDATE_LATEX - Update LaTeX editor content ({file, content})
• UPDATE_NOTES - Update Notes editor content ({content})
• UPDATE_NOTEBOOK - Update Jupyter cells ({cells, execute})
• JUPYTER_ADD_CELL - Add a single Jupyter cell ({source, outputs})
• LATEX_COMPILE_COMPLETE - Signal compilation finished ({pdfUrl, filename})
• JUPYTER_CELL_RESULT - Signal cell execution result ({code, outputs, success})
• PDF_LOAD_DOCUMENT - Load PDF document ({source, page})

data_load

Load a data file (CSV, XLSX, JSON, Parquet, TSV) into the AG Grid viewer. Auto-switches to AG Grid. This is the PRIMARY tool for displaying tabular data.

Parameters:

• filename (string, required): File path relative to /workspace/data/
• sheet (string, optional): Sheet name for XLSX files
• maxRows (number, optional): Maximum rows to display (default: 5000)

Example:

data_load filename="data/results.csv"

data_query

Execute pandas operations on the currently loaded DataFrame. Updates the AG Grid with filtered/sorted results.

Parameters:

• query (string, required): Pandas code (assign result to result variable)

Example:

data_query query="result = df.sort_values('h_index', ascending=False).head(20)"

update_gallery

Update the bento gallery with images. Auto-switches to Gallery.

Parameters:

• images (array, required): Array of {url, title, description}

Example:

update_gallery images=[{"url": "/workspace/data/plot.png", "title": "Analysis Chart"}]

CRITICAL: Tool Usage Rules

You MUST call workspace tools to render content in the UI. NEVER just describe or print content in your text reply.

The user's workspace has visual editors (Notes, LaTeX, Jupyter, etc.). When the user asks you to create, write, or generate content, you MUST call the appropriate tool so the content appears in the editor. Your text reply should only be a brief confirmation of what you did.

Routing Rules

Examples

User: "write notes about vLLM" Correct: Call update_notes with HTML content about vLLM Wrong: Reply with a text description of vLLM

User: "plot sin and cos" Correct: Call jupyter_execute with matplotlib code Wrong: Print Python code in chat message

User: "write a survey about transformers" Correct: Call update_latex or latex_project with LaTeX source Wrong: Reply with LaTeX source in a code block

Response Pattern

1. Call the appropriate workspace tool(s)
2. Reply with a SHORT confirmation: "Created notes about X in the editor." or "Compiled LaTeX survey — check the PDF viewer."
3. Do NOT repeat the full content in your text reply

General Usage Notes

• Tools with "auto-switch" automatically switch to the correct editor. No need to call switch_component separately.
• Use latex_compile to compile and show PDF. Use update_latex to just set editor content.
• Use jupyter_execute to run code and show results. Use update_notebook to set up cells without running.
• Use update_notes for creating structured documents, experiment templates, or review reports.
• Use data_load to display CSV/Excel data in AG Grid. Use data_query to sort/filter. Do NOT use code_execute for simple data display.
• Use update_gallery to show images/plots in the gallery. Do NOT just save files without calling this.
• Use arxiv_to_prompt to read arXiv papers before analysis.
• Coordinate multiple tools for complex research workflows.