Agent skill

Bilig Workpaper

by agent-skills-hub in agent-skills-hub/agent-skills-hub

Formula WorkPaper runtime and MCP server for AI agents and Node.js services.

MITAuto-check passedDocuments & Office

Install Bilig Workpaper

skills CLI
$ npx skills add agent-skills-hub/agent-skills-hub --skill bilig-workpaper -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install agent-skills-hub/agent-skills-hub bilig-workpaper --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/agent-skills-hub/agent-skills-hub.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/bilig-workpaper .claude/skills/bilig-workpaper && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
bilig-workpaper
GitHub stars
112
Token cost
~931 tokens
SKILL.md length
406 words
Files
1
Skills in repo
19
Repo updated
First seen
Licence
MIT

At a glance

Formula WorkPaper runtime and MCP server for AI agents and Node.js services.

  • Works in 4 steps: Install or run the package → Prefer WorkPaper state over UI automation → Use the MCP tools for agent workflows → …
  • An agent needs spreadsheet-style formulas
  • SKILL.md covers Overview, When to Use This Skill, Step-by-Step Guide and Examples, plus 2 more sections
  • Calls npm

What it does

Bilig Workpaper is an agent skill from agent-skills-hub/agent-skills-hub. Formula WorkPaper runtime and MCP server for AI agents and Node.js services. Use when an agent needs spreadsheet-style formulas, cell edits, recalculation, readback verification, or persisted WorkPaper JSON without driving Excel UI.

Its SKILL.md is about 930 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office, covering Excel spreadsheets and MCP servers. It works with Model Context Protocol, Microsoft Excel and Node.js. The repository describes itself as: Agent Skills Hub is a global library of AI agent skills that work across OpenClaw, Claude Code, Gemini, Cursor, Antigravity, and more. The licence is MIT.

When your agent uses it

  • An agent needs spreadsheet-style formulas
  • Readback verification
  • Persisted WorkPaper JSON without driving Excel UI

Example prompts

  • “/bilig-workpaper”

Requirements

  • Node.js

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Install or run the package
  2. Prefer WorkPaper state over UI automation
  3. Use the MCP tools for agent workflows
  4. Verify after every mutation

What it can do on your machine

Read from SKILL.md and the folder at commit efc0b96. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Bilig Workpaper loads about 931 tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 406 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~62
When it runs · the whole SKILL.md, loaded when a task matches
~931

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from agent-skills-hub/agent-skills-hub at commit efc0b96, republished under its MIT licence (© agent-skills-hub). 406 words, ~931 tokens.

Download SKILL.mdSave it as .claude/skills/bilig-workpaper/SKILL.md (or your agent's skills folder).
name
bilig-workpaper
description
Formula WorkPaper runtime and MCP server for AI agents and Node.js services. Use when an agent needs spreadsheet-style formulas, cell edits, recalculation, readback verification, or persisted WorkPaper JSON without driving Excel UI.
risk
safe
source
proompteng/bilig (MIT)

Bilig WorkPaper

Overview

Bilig WorkPaper gives agents a reviewable spreadsheet model without requiring browser or Excel UI automation. Use it to edit cells through an API, recalculate formulas, verify display-value readback, and persist WorkPaper JSON for audit or restore flows.

When to Use This Skill

  • Use when an agent needs spreadsheet-style formulas in a backend service or local workflow.
  • Use when the task involves editing input cells, recalculating formulas, and proving the output with readback.
  • Use when Excel, Google Sheets, or screenshot-driven spreadsheet automation would be too brittle.
  • Use when a workflow needs file-backed WorkPaper JSON that can be reviewed, restored, or versioned.

Step-by-Step Guide

1. Install or run the package

Use the package directly with npm exec when you only need the MCP server:

bash
npm exec --package @bilig/headless -- bilig-workpaper-mcp --workpaper ./pricing.workpaper.json --init-demo-workpaper --writable

For TypeScript code, install the package in the project:

bash
npm install @bilig/headless
2. Prefer WorkPaper state over UI automation

Keep workbook state in a WorkPaper JSON document. Write inputs through the WorkPaper API or MCP tools, recalculate, then read the computed display value back from the model.

3. Use the MCP tools for agent workflows

A file-backed MCP session should expose tools for listing sheets, reading cells or ranges, setting cell contents, validating formulas, exporting the document, and reading display values after recalculation.

4. Verify after every mutation

After each write, read the changed input cell and the dependent output cell. Keep the exported WorkPaper JSON when the task needs proof, rollback, or a reproducible bug report.

Examples

Show full SKILL.md (166 more words)Show less
Example 1: File-backed MCP server
bash
npm exec --package @bilig/headless -- bilig-workpaper-mcp --workpaper ./pricing.workpaper.json --init-demo-workpaper --writable

An agent can then update Inputs!B3, read Summary!B3, and export the updated WorkPaper JSON.

Example 2: TypeScript service workflow
ts
import { WorkPaper } from "@bilig/headless";

const paper = new WorkPaper();
paper.setCellContents("Inputs", "B2", 1200);
paper.setCellContents("Inputs", "B3", "=B2*1.2");
paper.recalculate();

const result = paper.getCellDisplayValue("Inputs", "B3");
console.log(result);

Best Practices

  • Do use Bilig for formulas, readback, and persisted spreadsheet state when the workflow can live outside Excel UI.
  • Do keep formula inputs, computed outputs, and exported WorkPaper JSON together when reporting bugs or validating agent changes.
  • Do validate formulas before writing them into cells when the agent is generating formulas.
  • Don't use screenshot or browser automation for spreadsheet logic if a WorkPaper API call can express the same operation directly.
  • Don't treat a write as complete until a readback proves the computed output changed as expected.

Troubleshooting

Problem: The agent wrote a formula but the output did not change.
Solution: Recalculate the WorkPaper, then read both the input cell and the dependent display-value cell.

Problem: The workflow needs to preserve state across agent turns.
Solution: Run the MCP server with --workpaper ./file.workpaper.json --writable and export the document after important changes.

© agent-skills-hub, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/bilig-workpaper of agent-skills-hub/agent-skills-hub.

Open the folder on GitHubat commit efc0b96

Compare with similar skills

Bilig Workpaper next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Bilig Workpaper compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bilig Workpaper this skillagent-skills-hub/agent-skills-hub112—~931Automated safety check: PassMIT
MCP Gatewaytmustier/pi-for-excel434—~241Automated safety check: PassMIT
Autocad Tianzheng Hvachashgraph-online/awesome-codex-plugins1.3k—~762Automated safety check: PassApache-2.0
Bilig Workpapersickn33/agentic-awesome-skills47k1 repos~1.3kAutomated safety check: PassMIT
DatalionHybridAIOne/hybridclaw159—~2.8kAutomated safety check: PassMIT
Ot Cost Analysisaiskillstore/marketplace433—~4.4kAutomated safety check: PassNone

Similar skills

  • MCP Gateway

    tmustier/pi-for-excel

    Discover and call tools from configured MCP servers. An agent skill from tmustier/pi-for-excel.

    434 GitHub stars~241 tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Autocad Tianzheng Hvac

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when controlling AutoCAD 2026 with Tianzheng HVAC T30 through the autocadtianzheng MCP server, including connecting the THvac30V1 profile, reading or creating DWG engineering…

    1.3k GitHub stars~762 tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Bilig Workpaper

    sickn33/agentic-awesome-skills

    Use formula-backed WorkPaper JSON and MCP tools for agent spreadsheet tasks without driving Excel or a browser UI.

    47k GitHub starsUsed in 1 repo~1.3k tokens
    Documents & OfficeAuto-check passed
  • Datalion

    HybridAIOne/hybridclaw

    A skill your agent uses for DataLion workflows such as listing, reading, creating, or editing projects, inspecting data sources, importing Excel or CSV data, working with reports and report tabs and…

    159 GitHub stars~2.8k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Ot Cost Analysis

    aiskillstore/marketplace

    Trigger for: Other Transaction or OT should-cost, cost estimate, cost-share analysis, milestone pricing, funding profile, proposed-price comparison, prototype price analysis, research OT budget…

    433 GitHub stars~4.4k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Datapack Builder

    w95/awesome-claude-corporate-skills

    Build professional financial services data packs from various sources including CIMs, offering memorandums, SEC filings, web search, or MCP servers.

    244 GitHub starsUsed in 1 repo~6k tokens
    Business, Finance & HRAuto-check passed

More from agent-skills-hub/agent-skills-hub

All 19 skills in this repo
  • Open Notebook

    agent-skills-hub/agent-skills-hub

    Drives a self-hosted Open Notebook instance to organize sources into notebooks, chat with documents, generate notes and multi-speaker podcasts, and search across material.

    112 GitHub starsUsed in 3 repos~2.6k tokens
    Auto-check passed
  • Timesfm Forecasting

    agent-skills-hub/agent-skills-hub

    Zero-shot time series forecasting with Google's TimesFM foundation model.

    112 GitHub starsUsed in 1 repo~7.8k tokens
    Auto-check: notes
  • Pyzotero

    agent-skills-hub/agent-skills-hub

    Interact with Zotero reference management libraries using the pyzotero Python client.

    112 GitHub starsUsed in 4 repos~1.1k tokens
    Auto-check: notes
  • Alpha Vantage

    agent-skills-hub/agent-skills-hub

    Access real-time and historical stock market data, forex rates, cryptocurrency prices, commodities, economic indicators, and 50+ technical indicators via the Alpha Vantage API.

    112 GitHub starsUsed in 2 repos~1.6k tokens
    Auto-check passed
  • Build Sdf Liquid Glass

    agent-skills-hub/agent-skills-hub

    Build lightweight SDF/canvas displacement glass with Vaso. An agent skill from agent-skills-hub/agent-skills-hub.

    112 GitHub stars~674 tokensUpdated 9 days ago
    Auto-check passed
  • Edgartools

    agent-skills-hub/agent-skills-hub

    Python library for accessing, analyzing, and extracting data from SEC EDGAR filings.

    112 GitHub starsUsed in 2 repos~1.4k tokens
    Auto-check passed

Questions about Bilig Workpaper

What does Bilig Workpaper do?

Formula WorkPaper runtime and MCP server for AI agents and Node.js services. Bilig Workpaper is an agent skill from agent-skills-hub/agent-skills-hub.js services.

When should I use Bilig Workpaper?

Bilig Workpaper fits situations like: an agent needs spreadsheet-style formulas; readback verification; persisted WorkPaper JSON without driving Excel UI.

How do I install Bilig Workpaper in Claude Code?

Run `npx skills add agent-skills-hub/agent-skills-hub --skill bilig-workpaper -a claude-code`. Or copy the skill folder (skills/bilig-workpaper in agent-skills-hub/agent-skills-hub) into .claude/skills/bilig-workpaper in your project. Claude Code loads it when a task matches its description.

How do I install Bilig Workpaper in Codex?

Run `npx skills add agent-skills-hub/agent-skills-hub --skill bilig-workpaper -a codex`. Or copy the skill folder (skills/bilig-workpaper in agent-skills-hub/agent-skills-hub) into .agents/skills/bilig-workpaper in your project. Codex loads it when a task matches its description.

Can I use Bilig Workpaper in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add agent-skills-hub/agent-skills-hub --skill bilig-workpaper -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bilig-workpaper, .gemini/skills/bilig-workpaper, .github/skills/bilig-workpaper and .opencode/skills/bilig-workpaper in your project.

What does Bilig Workpaper need to run?

Going by SKILL.md and its folder, Bilig Workpaper needs the command-line tools its instructions call (npm). Our summary lists: Node.js.

Does Bilig Workpaper access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Bilig Workpaper safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Bilig Workpaper use?

Bilig Workpaper is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Bilig Workpaper use?

About 931 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Bilig Workpaper?

Skills that share tags, products or a category with Bilig Workpaper: MCP Gateway (tmustier/pi-for-excel, 434 stars), Autocad Tianzheng Hvac (hashgraph-online/awesome-codex-plugins, 1.3k stars), Bilig Workpaper (sickn33/agentic-awesome-skills, 47k stars) and Datalion (HybridAIOne/hybridclaw, 159 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bilig Workpaper?

agent-skills-hub (a GitHub organization) maintains it in agent-skills-hub/agent-skills-hub, which has 112 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 2, 2026.

Source: agent-skills-hub/agent-skills-hub on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.