beaver_project/skills/officebench-mcp/versions/v0001/SKILL.md

---
name: officebench-mcp
description: Guidance for OfficeBench evaluation tasks. Use the registered mcp_officebench_* tools to inspect and edit OfficeBench files, spreadsheets, documents, emails, calendars, PDFs, and answer files.
always: true
tools:
  - mcp_officebench_excel_read_file
  - mcp_officebench_excel_set_cell
  - mcp_officebench_excel_delete_cell
  - mcp_officebench_excel_create_new_file
  - mcp_officebench_excel_convert_to_pdf
  - mcp_officebench_word_read_file
  - mcp_officebench_word_write_to_file
  - mcp_officebench_word_create_new_file
  - mcp_officebench_word_convert_to_pdf
  - mcp_officebench_email_list_emails
  - mcp_officebench_email_read_email
  - mcp_officebench_email_send_email
  - mcp_officebench_calendar_create_event
  - mcp_officebench_calendar_list_events
  - mcp_officebench_calendar_delete_event
  - mcp_officebench_pdf_read_file
  - mcp_officebench_pdf_convert_to_word
  - mcp_officebench_pdf_convert_to_image
  - mcp_officebench_ocr_recognize_file
  - mcp_officebench_shell_command
  - mcp_officebench_shell_list_directory
  - mcp_officebench_shell_read_file
  - mcp_officebench_shell_write_file
  - mcp_officebench_shell_copy_file
  - mcp_officebench_system_finish_task
  - mcp_officebench_system_get_status
  - mcp_officebench_image_convert_to_pdf
---

# OfficeBench MCP Skill

Use this skill for OfficeBench evaluation runs. OfficeBench task files live in the OfficeBench MCP server, not in Beaver's local filesystem. Complete the task by calling real `mcp_officebench_*` tools.

## Critical Rules

1. Use actual Beaver tool calls only. Do not print XML, DSML, JSON, or markdown that describes a tool call.
2. Never invent tool names. If you need to find files, use `mcp_officebench_shell_list_directory` or `mcp_officebench_shell_command`.
3. Do not use Beaver local filesystem, local runtime, local terminal, or local code tools for OfficeBench files.
4. Paths are relative to `/testbed` in the OfficeBench MCP container, such as `data/score.xlsx`.
5. If the task context gives a `workspace_id`, pass that same `workspace_id` argument in every OfficeBench MCP tool call that supports it.
6. Inspect files before editing them.
7. Verify the requested output file or edited cell exists before finishing.
8. Finish every task with `mcp_officebench_system_finish_task`.

## Tool Names And Use

### Excel

Use these for `.xlsx` files:

- `mcp_officebench_excel_read_file`: read workbook sheets and cell values.
  - Required: `file_path`
  - Optional: `sheet_name`, `workspace_id`
- `mcp_officebench_excel_set_cell`: write one cell.
  - Required: `file_path`, `row`, `col`, `value`
  - Optional: `sheet_name`, `workspace_id`
  - Rows and columns are 1-based.
- `mcp_officebench_excel_delete_cell`: clear one cell.
  - Required: `file_path`, `row`, `col`
  - Optional: `sheet_name`, `workspace_id`
- `mcp_officebench_excel_create_new_file`: create a workbook.
  - Required: `file_path`
  - Optional: `workspace_id`
- `mcp_officebench_excel_convert_to_pdf`: convert an Excel file to PDF.
  - Required: `file_path`
  - Optional: `workspace_id`

Typical Excel sequence:

1. Call `mcp_officebench_shell_list_directory` on `data`.
2. Call `mcp_officebench_excel_read_file` on the target workbook.
3. Identify the exact row and column.
4. Call `mcp_officebench_excel_set_cell`.
5. Read the workbook again or use status/listing to verify.
6. Call `mcp_officebench_system_finish_task`.

For the common task "change Bob's midterm1 score to 100 in score.xlsx", inspect `data/score.xlsx`, find Bob's row and the `midterm1` column, then call `mcp_officebench_excel_set_cell` with that row, that column, and value `100`.

### Word

Use these for `.docx` files:

- `mcp_officebench_word_read_file`: read all paragraphs.
  - Required: `file_path`
  - Optional: `workspace_id`
- `mcp_officebench_word_write_to_file`: overwrite or append text.
  - Required: `file_path`, `text`
  - Optional: `append`, `workspace_id`
- `mcp_officebench_word_create_new_file`: create a new Word document.
  - Required: `file_path`
  - Optional: `workspace_id`
- `mcp_officebench_word_convert_to_pdf`: convert Word to PDF.
  - Required: `file_path`
  - Optional: `workspace_id`

Preserve exact spelling, capitalization, punctuation, and line order from source files.

### Email

Use these for email tasks:

- `mcp_officebench_email_list_emails`: list available `.eml` messages.
  - Optional: `folder`, `workspace_id`
- `mcp_officebench_email_read_email`: read one email.
  - Required: `email_path`
  - Optional: `workspace_id`
- `mcp_officebench_email_send_email`: create/send an email artifact.
  - Required: `to`, `subject`, `body`
  - Optional: `attachments`, `workspace_id`

For email-search tasks, final answers should use plain text with literal lines like `Subject: ...`. Do not add markdown labels.

### Calendar

Use these for calendar `.ics` tasks:

- `mcp_officebench_calendar_list_events`: inspect calendar events.
  - Optional: `calendar_path`, `workspace_id`
- `mcp_officebench_calendar_create_event`: create an event.
  - Required fields depend on the task; include summary/title, start, end, and target calendar when needed.
  - Optional: `workspace_id`
- `mcp_officebench_calendar_delete_event`: delete an event.
  - Required fields depend on the task; inspect events first.
  - Optional: `workspace_id`

Use the task's current date/time context when interpreting relative dates.

### PDF, OCR, And Images

Use these for PDF/image tasks:

- `mcp_officebench_pdf_read_file`: extract text from a PDF.
  - Required: `pdf_file_path`
  - Optional: `workspace_id`
- `mcp_officebench_pdf_convert_to_word`: convert PDF to Word.
  - Required: `pdf_file_path`
  - Optional: `workspace_id`
- `mcp_officebench_pdf_convert_to_image`: convert one PDF page to an image.
  - Required: `pdf_file_path`
  - Optional: `page_number`, `dpi`, `workspace_id`
- `mcp_officebench_ocr_recognize_file`: OCR an image.
  - Required: `image_path`
  - Optional: `language`, `workspace_id`
- `mcp_officebench_image_convert_to_pdf`: convert image to PDF.
  - Required: `image_path`
  - Optional: `output_path`, `workspace_id`

For conversion tasks, create the exact requested filename and verify it exists.

### Shell And System

Use these for safe file discovery and text files:

- `mcp_officebench_shell_list_directory`: list a directory.
  - Optional: `path`, `workspace_id`
- `mcp_officebench_shell_read_file`: read text files such as `.txt`, `.csv`, `.json`, `.md`, `.xml`.
  - Required: `file_path`
  - Optional: `workspace_id`
- `mcp_officebench_shell_write_file`: write text files.
  - Required: `file_path`, `content`
  - Optional: `append`, `workspace_id`
- `mcp_officebench_shell_copy_file`: copy a file or directory.
  - Required: `source`, `destination`
  - Optional: `workspace_id`
- `mcp_officebench_shell_command`: run shell commands inside the OfficeBench MCP container.
  - Required: `command`
  - Optional: `workdir`, `workspace_id`
- `mcp_officebench_system_get_status`: inspect filesystem/git status.
  - Optional: `workspace_id`
- `mcp_officebench_system_finish_task`: mark the task complete and optionally write an answer.
  - Optional: `answer`, `workspace_id`

Prefer dedicated Office tools for Office documents. Use shell tools for listing directories, copying/renaming files, and reading/writing plain text.

## Anti-Patterns

Do not do any of the following:

- Do not call `mcp_officebench_find_in_workspace`; that tool does not exist.
- Do not output `<tool_calls>`, `<invoke>`, DSML, or pseudo tool call text.
- Do not answer "done" without calling the required OfficeBench tools.
- Do not edit guessed paths without first listing or reading relevant files.
- Do not use `/testbed` as a literal prefix in path arguments unless a tool explicitly asks for an absolute path.
- Do not correct misspellings found in source data. Preserve source text exactly.