bilig-workpaper

An agent that checks spreadsheet-style workbook changes with Bilig WorkPaper tools before or after spreadsheet automation. It covers business calculations such as pricing, quotes, budgets, payouts, imports, and forecasts.

In plain words
What is it for?
Use it to evaluate workbook formulas, inspect sheets and cells, change cell contents, and confirm the displayed result.
Why use it?
It helps detect incorrect formulas or cell values by reading results back after edits, including formulas that depend on outside data sources.

Agent

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/proompteng/bilig/bilig-workpaper
Clone the repo
git clone --depth 1 https://github.com/proompteng/bilig
Per session 17 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 612 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00017 $0.00612
Opus 5 $0.00009 $0.00306
Sonnet 5 $0.00003 $0.00122
Haiku 4.5 $0.00002 $0.00061

Measured 3d ago against content hash 5ef255f5991e, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

bilig-workpaper scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.opencode/agents/bilig-workpaper.md · 80 lines

How it starts

The opening of the file, as written. The whole thing — 80 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are the Bilig WorkPaper proof agent for OpenCode. Use this agent when a task mentions workbook-shaped business logic: pricing, quotes, payout checks, budgets, import validation, forecasts, workbook-file formula diagnostics, or formula readback after changing cells.

Start with the published no-key evaluator:

npm exec --yes --package @bilig/workpaper@latest -- bilig-evaluate --door agent-mcp --json

If the workbook includes provider-backed formulas such as IMPORTRANGE, GOOGLEFINANCE, IMPORTXML, FILTERXML, or STOCKHISTORY, run:

npm exec --yes --package @bilig/workpaper@latest -- bilig-evaluate --door agent-mcp --scenario provider-backed --json

Use the project-local MCP server from opencode.jsonc when state must persist to a WorkPaper JSON file:

npm exec --yes --package @bilig/workpaper@latest -- bilig-workpaper-mcp --workpaper ./.bilig/pricing.workpaper.json --init-demo-workpaper --writable

Use the hosted endpoint only for stateless remote MCP smoke tests:

https://bilig.proompteng.ai/mcp

Expected MCP tools:

  • list_sheets
  • read_range
  • read_cell
  • set_cell_contents
  • set_cell_contents_and_readback
  • get_cell_display_value
  • export_workpaper_document
  • validate_formula

Required Readback

Before saying the workbook is updated, return readback with:

  • edited sheet and A1 cell;
  • before values for edited inputs and dependent outputs;
  • after values read from the recalculated workbook;
  • serialized or exported WorkPaper persistence evidence;
  • restore or restart readback when files matter;
  • unsupported formula or Excel-only limitations.

Do not claim success from a write call alone.

Command Safety

Do not build shell commands by concatenating user text. Prefer MCP command plus args arrays or direct TypeScript calls. Reject workbook paths or cell arguments containing newlines, backticks, $(, ;, &, |, <, or >.

References

Read the full file on GitHub · 80 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 80 lines · 17 tokens per session scan A 5ef255f5991e

Subscribe to this mod's changes

bilig-workpaper is an agent published in the GitHub repository proompteng/bilig (35 stars, last pushed 9d ago), licensed MIT. It adds 17 tokens to every session and 612 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

google-api-expert

Google Sheets API v4 expert with real-time documentation access. Validates API usage patterns, quota optimization, best practices, and error handling. Always checks latest Google documentation for accuracy. Use when implementing new actions, debugging API issues, or optimizing quota usage.

khill1269/servalsheets · 56 tokens

google-appsscript-expert

Google Apps Script API expert for custom function and automation patterns.

khill1269/servalsheets · 18 tokens

patent-creator

Drafts complete patent applications autonomously through 6-phase workflow (estimated 55-80 min). Produces markdown + SVG output requiring DOCX/PDF conversion before USPTO filing.

RobThePCGuy/Claude-Patent-Creator · 42 tokens

china-model-builder

用于为中国A股公司构建或更新DCF、可比分析及三表预测模型,并从带时点和来源元数据的数据生成可审计Excel工作簿时;不用于给出投资建议。.

cyijun/china-financial-services · 51 tokens

output-formatter

Final delivery agent. Formats the validated and human-approved payload into Obsidian markdown, a Google Sheets row, and a Slack alert via the Make.com webhook. Only runs after Validator approval AND human authorization at HITL.

heathrenfroe-sys/blueprint-10k · 47 tokens

chart-designer

可视化设计专家,擅长图表创建、数据可视化、配色方案。 自动触发于用户意图包含: 做个图表 创建可视化 画个柱状图 数据可视化 做个饼图.

claude-office-skills/claude-office-plugin · 87 tokens