bilig-workpaper

Bilig WorkPaper Agent Skill

Use this skill when an agent needs spreadsheet-style formulas but the work should run through files, terminal commands, TypeScript, HTTP routes, or MCP tools instead of Excel UI automation.

When To Trigger

Trigger this skill for tasks involving:

• workbook-shaped business logic in Node.js services;
• formula readback after writing cells;
• quote, budget, payout, pricing, import-validation, or forecast models;
• agent spreadsheet tools that need deterministic cell addresses;
• MCP clients that can run a stdio server or call a Streamable HTTP endpoint;
• reduced formula/import bugs that need a local report.

Do not trigger it for manual spreadsheet editing, Office macros, VBA, pivots, charts, COM automation, or exact Excel desktop behavior unless the user explicitly asks to compare Bilig against an Excel oracle.

Command Safety

Do not build shell commands by concatenating user text. Treat the commands below as literal templates, validate workbook paths before use, and reject values containing newlines, backticks, $(, ;, &, |, <, or >. Prefer MCP client command plus args arrays or direct TypeScript calls when inserting user-provided paths or cell references.

First Check: Agent Triage

Before wiring a client or opening a spreadsheet UI, print the compact decision card:

{
  "command": "npm",
  "args": ["exec", "--yes", "--package", "@bilig/workpaper@latest", "--", "bilig-agent-start", "--json"]
}

First Check: Agent Evaluator

Before wiring a client, prove the published agent door with the package-owned evaluator. It exercises MCP discovery, cell mutation, formula readback, JSON export, restart restore, and returns verified: true:

{
  "command": "npm",
  "args": ["exec", "--yes", "--package", "@bilig/workpaper@latest", "--", "bilig-evaluate", "--door", "agent-mcp", "--json"]
}

For service-owned WorkPaper logic without MCP, run bilig-evaluate --door workpaper-service --json. Use the lower-level challenge commands only when debugging the direct API loop or file-backed MCP JSON-RPC transcript: