Agent skill

Bilig Workpaper

by sickn33 in sickn33/agentic-awesome-skills

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

MITAuto-check passedDocuments & Office

Install Bilig Workpaper

skills CLI
$ npx skills add sickn33/agentic-awesome-skills --skill bilig-workpaper -a claude-code

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

GitHub CLI
$ gh skill install sickn33/agentic-awesome-skills 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/sickn33/agentic-awesome-skills.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
47k
Used in
1 other repo
Token cost
~1.3k tokens
SKILL.md length
457 words
Files
1
Skills in repo
1,493
Repo updated
First seen
Licence
MIT

At a glance

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

  • Mula-backed WorkPaper JSON and MCP tools for agent spreadsheet tasks without driving Excel
  • SKILL.md covers Overview, When To Use This Skill, Safer Command Pattern and Quick MCP Setup, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve Excel spreadsheets

What it does

Bilig Workpaper is an agent skill from sickn33/agentic-awesome-skills. Use formula-backed WorkPaper JSON and MCP tools for agent spreadsheet tasks without driving Excel or a browser UI.

Its SKILL.md is about 1.3k 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 Microsoft Excel and Model Context Protocol. The repository describes itself as: AAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,400+ agentic skills. Includes… The licence is MIT.

When your agent uses it

  • Mula-backed WorkPaper JSON and MCP tools for agent spreadsheet tasks without driving Excel
  • Tasks that involve Excel spreadsheets
  • Tasks that involve MCP servers

Example prompts

  • “/bilig-workpaper”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit 680176d. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json and typescript).

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

  • Network

    Links to these hosts (documentation or services it may open):

    • proompteng.github.io
    • github.com

    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 1.3k tokens when it runs. Until then it costs about 33 tokens; SKILL.md has 457 words of instructions outside code blocks.

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

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 sickn33/agentic-awesome-skills at commit 680176d, republished under its MIT licence (© sickn33). 457 words, ~1,305 tokens.

Download SKILL.mdSave it as .claude/skills/bilig-workpaper/SKILL.md (or your agent's skills folder).
name
bilig-workpaper
description
Use formula-backed WorkPaper JSON and MCP tools for agent spreadsheet tasks without driving Excel or a browser UI.
risk
critical
source
community
date_added
2026-05-21
tags
spreadsheets, formulas, mcp, xlsx, typescript

Bilig WorkPaper

Overview

Bilig WorkPaper gives agents a code-first workbook runtime for spreadsheet-style business logic. Use it when the task is easier to model as sheets and formulas, but the reliable path is to edit cells through an API, recalculate, read computed values back, and persist a JSON workbook document.

The main use case is replacing fragile spreadsheet UI automation with deterministic tool calls. It is useful for quote calculators, payout models, budget checks, import validation, and reduced XLSX formula bug reports.

When To Use This Skill

Use this skill when the user needs to:

  • work with spreadsheet formulas from a Node.js service, route, test, or agent tool;
  • write workbook inputs and verify calculated outputs with readback proof;
  • persist a formula workbook as reviewable WorkPaper JSON;
  • expose a file-backed workbook through MCP tools;
  • investigate an XLSX formula recalculation issue without automating Excel, LibreOffice, or a browser grid.

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

Safer Command Pattern

Prefer argument arrays in MCP/client configuration. Do not shell-concatenate user-provided paths, sheet names, formulas, or cell addresses. Reject path or cell input containing newlines, backticks, $(, ;, &, |, <, or > before using it in a command.

The MCP examples execute the public @bilig/workpaper npm package. Treat that as third-party code execution: pin the package version you reviewed, run it only in a trusted project, and get explicit user approval before starting a writable MCP server.

Show full SKILL.md (206 more words)Show less

Quick MCP Setup

First prove the package-owned challenge works:

json
{
  "command": "npm",
  "args": ["exec", "--package", "@bilig/workpaper@<reviewed-version>", "--", "bilig-mcp-challenge"]
}

Then run a writable file-backed MCP server:

json
{
  "command": "npm",
  "args": [
    "exec",
    "--package",
    "@bilig/workpaper@<reviewed-version>",
    "--",
    "bilig-workpaper-mcp",
    "--workpaper",
    "./pricing.workpaper.json",
    "--init-demo-workpaper",
    "--writable"
  ]
}

Useful tools exposed by the MCP server:

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

After every write, read the dependent output cell and export the WorkPaper document. Do not claim success from the write call alone.

Direct TypeScript Pattern

Use the package directly when workbook logic belongs inside application code:

ts
import {
  WorkPaper,
  exportWorkPaperDocument,
  serializeWorkPaperDocument,
} from "@bilig/workpaper";

const workbook = WorkPaper.buildFromSheets({
  Inputs: [
    ["Metric", "Value"],
    ["Customers", 20],
    ["Average revenue", 1200],
  ],
  Summary: [
    ["Metric", "Value"],
    ["Revenue", "=Inputs!B2*Inputs!B3"],
  ],
});

const inputs = workbook.getSheetId("Inputs");
const summary = workbook.getSheetId("Summary");
if (inputs === undefined || summary === undefined) {
  throw new Error("Workbook is missing required sheets");
}

workbook.setCellContents({ sheet: inputs, row: 1, col: 1 }, 32);
const revenue = workbook.getCellDisplayValue({ sheet: summary, row: 1, col: 1 });
const saved = serializeWorkPaperDocument(
  exportWorkPaperDocument(workbook, { includeConfig: true }),
);

console.log({ revenue, savedBytes: saved.length });

Required Verification

A good agent response should include:

  • exact sheet names and A1 cells edited;
  • before values for important inputs and dependent outputs;
  • after values read from the recalculated workbook;
  • persistence evidence from exported or serialized WorkPaper JSON;
  • restore or reimport proof when file boundaries matter;
  • clear limitations for unsupported formulas or Excel-only behavior.

If any proof step fails, report the blocker instead of saying the workbook was updated.

Limitations

  • WorkPaper behavior is not a complete replacement for desktop Excel, VBA, pivots, charts, or UI automation.
  • Formula compatibility depends on the Bilig runtime and should be verified against Excel when exact parity matters.
  • MCP writes should remain scoped to trusted workbook paths and must be followed by readback validation.

References

© sickn33, 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 sickn33/agentic-awesome-skills.

Open the folder on GitHubat commit 680176d

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in sickn33/agentic-awesome-skills, which our catalogue first saw on October 7, 2026.

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 skillsickn33/agentic-awesome-skills47k1 repos~1.3kAutomated safety check: PassMIT
MCP Gatewaytmustier/pi-for-excel434—~241Automated safety check: PassMIT
DatalionHybridAIOne/hybridclaw158—~2.8kAutomated safety check: PassMIT
Datapack Builderw95/awesome-claude-corporate-skills2391 repos~6kAutomated safety check: PassMIT
Ot Cost Analysisaiskillstore/marketplace430—~4.4kAutomated safety check: PassNone
Autocad Tianzheng Hvachashgraph-online/awesome-codex-plugins1.3k—~762Automated safety check: PassApache-2.0

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 today
    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…

    158 GitHub stars~2.8k tokensUpdated today
    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.

    239 GitHub starsUsed in 1 repo~6k tokens
    Business, Finance & HRAuto-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…

    430 GitHub stars~4.4k tokensUpdated today
    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 today
    Documents & OfficeAuto-check passed
  • Bilig Workpaper

    agent-skills-hub/agent-skills-hub

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

    111 GitHub stars~931 tokensUpdated 7 days ago
    Documents & OfficeAuto-check passed

More from sickn33/agentic-awesome-skills

All 1,493 skills in this repo
  • Liuguang Banlan UI

    sickn33/agentic-awesome-skills

    Implements an interface in one of two named color modes, iridescent white or colorful black, from a parameterized starter that reports measured color intensity.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • User Thoughts Memory

    sickn33/agentic-awesome-skills

    Saves a user's project decisions, rules and preferences into a project-local mdbase so later sessions and other agents can recover the intent.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Using LWC Memory and Graphs

    sickn33/agentic-awesome-skills

    Keeps project decisions, research and verified results available across coding-agent sessions through LWC memory, a document Wiki graph and a CodeGraph code index.

    47k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Find Complementary Founders

    sickn33/agentic-awesome-skills

    Guides an agent through assessing its own owner for cofounder fit, publishing an approved profile, and ranking complementary profiles other agents published for their owners.

    47k GitHub starsUsed in 1 repo~4.8k tokens
    Auto-check passed
  • Whatsapp Cloud API

    sickn33/agentic-awesome-skills

    Integracao com WhatsApp Business Cloud API (Meta). An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~4.5k tokens
    Auto-check passed
  • Cline Pilot

    sickn33/agentic-awesome-skills

    Acts as a proxy for the Cline CLI, dispatching coding tasks one at a time, monitoring runs by hard evidence, relaying decisions to you and learning per-project preferences.

    47k GitHub starsUsed in 1 repo~4.6k tokens
    Auto-check passed

Questions about Bilig Workpaper

What does Bilig Workpaper do?

Use formula-backed WorkPaper JSON and MCP tools for agent spreadsheet tasks without driving Excel or a browser UI. Bilig Workpaper is an agent skill from sickn33/agentic-awesome-skills. Use formula-backed WorkPaper JSON and MCP tools for agent spreadsheet tasks without driving Excel or a browser UI.

When should I use Bilig Workpaper?

Bilig Workpaper fits situations like: mula-backed WorkPaper JSON and MCP tools for agent spreadsheet tasks without driving Excel; tasks that involve Excel spreadsheets; tasks that involve MCP servers.

How do I install Bilig Workpaper in Claude Code?

Run `npx skills add sickn33/agentic-awesome-skills --skill bilig-workpaper -a claude-code`. Or copy the skill folder (skills/bilig-workpaper in sickn33/agentic-awesome-skills) 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 sickn33/agentic-awesome-skills --skill bilig-workpaper -a codex`. Or copy the skill folder (skills/bilig-workpaper in sickn33/agentic-awesome-skills) 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 sickn33/agentic-awesome-skills --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?

SKILL.md names no scripts, command-line tools or credentials: Bilig Workpaper is instructions for the agent only. Our summary lists: Node.js.

Does Bilig Workpaper access the network?

SKILL.md names 2 domains. As links in the text: proompteng.github.io and github.com. 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 1.3k tokens (SKILL.md is roughly 5.2k 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), Datalion (HybridAIOne/hybridclaw, 158 stars), Datapack Builder (w95/awesome-claude-corporate-skills, 239 stars) and Ot Cost Analysis (aiskillstore/marketplace, 430 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bilig Workpaper?

sickn33 (a GitHub user) maintains it in sickn33/agentic-awesome-skills, which has 47,379 GitHub stars. The repository holds 1,493 skills in this directory. The repository was last updated on October 9, 2026.

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