# Build WorkPaper Spreadsheet Automation

Agents often need spreadsheet logic without controlling Excel. This skill guides MCP and TypeScript workflows for WorkPaper formulas, file-backed edits, and local XLSX formula reports.

## Install

```bash
npx skillstore add proompteng/bilig-workpaper
```

## Metadata

- Status: approved
- Slug: proompteng-bilig-workpaper
- Version: 0.1.0
- Author version: 0.1.0
- Skillstore revision: r1
- Version status: valid
- Tree hash: a02ba731b1bba9ad480d964e432c5cf92305c35e3383b7aead85f8dc0af81ec9
- Author: proompteng
- GitHub username: proompteng
- License: MIT
- Repository: https://github.com/proompteng/bilig/tree/main/skills/bilig-workpaper
- Ref: 0519034dad657fb1f7706e0550e962beeda73fdf
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, network
- Quality score: 81
- Quality tier: silver
- Public page: https://skillstore.pages.dev/skills/proompteng-bilig-workpaper
- Manifest: https://skillstore.pages.dev/api/skills/proompteng-bilig-workpaper/manifest

## Capabilities

- Configure a WorkPaper MCP server with npm exec and argument arrays.
- List file-backed tools for reading, writing, exporting, and validating cells.
- Show direct TypeScript usage of @bilig/headless WorkPaper APIs.
- Guide local XLSX formula clinic reports for reduced workbook bugs.
- Define verification evidence after editing formulas or cells.

## Use Cases

- Build pricing workbook logic: Model quote, budget, payout, or forecast formulas in WorkPaper state and verify recalculated cells.
- Expose workbook edits through MCP: Configure file-backed MCP tools so agents can read, update, validate, and export workbook state.
- Report formula import bugs: Create a local formula clinic report from a reduced XLSX fixture with specific cells.

## Prompt Templates

### Start a WorkPaper edit

```
Use the Bilig WorkPaper skill to inspect my local pricing workbook, list the sheets, and explain which cells need verification.
```

### Configure MCP tools

```
Set up a WorkPaper MCP workflow for my forecast workbook using argument arrays. Include the tools I should call after each write.
```

### Verify formula changes

```
Change an input cell, read the dependent summary cell, export the WorkPaper state, and report before and after values.
```

### Prepare a formula clinic report

```
Use the formula clinic workflow for my reduced XLSX file. Focus on named cells and produce a concise local report summary.
```

## Limitations

- Does not automate Excel UI, macros, VBA, pivots, or charts.
- Does not claim exact Excel desktop behavior without an explicit comparison task.
- Requires the host to run npm or TypeScript tooling for examples.
- Requests reduced public fixtures instead of private customer spreadsheets.

## Best Practices

- Validate workbook paths and cell references before using them in tool arguments.
- Read dependent output cells after every write and include before and after values.
- Use reduced public fixtures when reporting XLSX formula issues.

## Anti Patterns

- Concatenating user text into shell commands.
- Claiming edits succeeded without reading recalculated outputs.
- Uploading private spreadsheets or using full customer workbooks for bug reports.

## Security Audit

- Audited at: 2026-07-09T11:59:45.72\+00:00
- Summary: The static command findings are Markdown backticks, inline tool names, and argument-array examples rather than Ruby or shell execution. The reference URLs point to project documentation and GitHub, and I found no prompt injection or data-exfiltration intent.

## Stats

- Views: 42
- Downloads: 17
- Favorites: 0
- Popularity score: 0