Agent skill

Exstruct CLI

by harumiWeb in harumiWeb/exstruct

Use ExStruct CLI to validate, inspect, create, and edit Excel workbooks safely.

BSD-3-ClauseAuto-check passedDocuments & Office

Install Exstruct CLI

skills CLI
$ npx skills add harumiWeb/exstruct --skill exstruct-cli -a claude-code

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

GitHub CLI
$ gh skill install harumiWeb/exstruct exstruct-cli --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/harumiWeb/exstruct.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/exstruct-cli .claude/skills/exstruct-cli && 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
exstruct-cli
GitHub stars
201
Token cost
~526 tokens
SKILL.md length
243 words
Files
7 (incl. references)
Skills in repo
8
Repo updated
First seen
Licence
BSD-3-Clause

At a glance

Use ExStruct CLI to validate, inspect, create, and edit Excel workbooks safely.

  • Works in 6 steps: Decide whether the request is create,… → Identify the needed op or inspect the… → Validate the workbook when the file,… → …
  • An agent needs exstruct patch
  • SKILL.md covers Select a command, Safety rules, Workflow and References
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Exstruct CLI is an agent skill from harumiWeb/exstruct. Use ExStruct CLI to validate, inspect, create, and edit Excel workbooks safely. Trigger when an agent needs exstruct patch, exstruct make, exstruct validate, exstruct ops list, or exstruct ops describe, especially for create-vs-edit decisions, dry-run workflows, backend constraints, or safe workbook-edit guidance.

Its SKILL.md is about 530 tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including reference files (for example `agents/openai.yaml`, `references/backend-constraints.md` and `references/command-selection.md`).

It sits in Documents & Office, covering Excel spreadsheets. It works with Microsoft Excel and Model Context Protocol. The repository describes itself as: Conversion from Excel to structured JSON (tables, shapes, charts) for LLM/RAG pipelines, and autonomous Excel reading/writing by AI agents via CLI and MCP integration. The licence is BSD-3-Clause.

When your agent uses it

  • An agent needs exstruct patch
  • Exstruct validate
  • Exstruct ops list
  • Exstruct ops describe

Example prompts

  • “/exstruct-cli”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Decide whether the request is create, edit, or actually an MCP-hosted task.
  2. Identify the needed op or inspect the public op schema.
  3. Validate the workbook when the file, backend, or request is uncertain.
  4. Run --dry-run for risky edits and inspect PatchResult.
  5. Apply the real edit only after the planned change is acceptable.
  6. Verify the result with the lightest step that still matches the user's risk.

What it can do on your machine

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

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

  • Network

    No URLs in SKILL.md.

    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

Exstruct CLI loads about 526 tokens when it runs, and up to ~2.3k if it reads all its reference files. Until then it costs about 85 tokens; SKILL.md has 243 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~85
When it runs · the whole SKILL.md, loaded when a task matches
~526
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.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 harumiWeb/exstruct at commit 9cdf9aa, republished under its BSD-3-Clause licence (© harumiWeb). 243 words, ~526 tokens.

Download SKILL.mdSave it as .claude/skills/exstruct-cli/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
exstruct-cli
description
Use ExStruct CLI to validate, inspect, create, and edit Excel workbooks safely. Trigger when an agent needs `exstruct patch`, `exstruct make`, `exstruct validate`, `exstruct ops list`, or `exstruct ops describe`, especially for create-vs-edit decisions, dry-run workflows, backend constraints, or safe workbook-edit guidance.

ExStruct CLI

Use the existing editing CLI as the default local operational interface for ExStruct workbook create/edit requests.

Select a command

  • Use exstruct make when the user wants a new workbook created and populated.
  • Use exstruct patch when the user wants an existing workbook edited.
  • Use exstruct validate when workbook readability is uncertain or before a risky edit on an unfamiliar file.
  • Use exstruct ops list when the required operation is still unclear.
  • Use exstruct ops describe <op> when you know the likely op name but need the exact schema or constraints.
  • Hand the workflow off to MCP when the user needs host-owned path policy, transport mapping, artifact mirroring, or other server-managed behavior.

Safety rules

  • Do not invent unsupported patch ops.
  • Do not apply destructive edits immediately when the request is ambiguous.
  • Prefer --dry-run before risky edits.
  • Pin --backend openpyxl when the dry run and the real apply must use the same engine.
  • Explain backend-specific failures directly instead of hiding them behind a generic retry.

Workflow

  1. Decide whether the request is create, edit, or actually an MCP-hosted task.
  2. Identify the needed op or inspect the public op schema.
  3. Validate the workbook when the file, backend, or request is uncertain.
  4. Run --dry-run for risky edits and inspect PatchResult.
  5. Apply the real edit only after the planned change is acceptable.
  6. Verify the result with the lightest step that still matches the user's risk.

References

  • references/command-selection.md
  • references/safe-editing.md
  • references/ops-guidance.md
  • references/verify-workflows.md
  • references/backend-constraints.md

© harumiWeb, BSD-3-Clause. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (references) in .agents/skills/exstruct-cli of harumiWeb/exstruct.

  • SKILL.md
  • agents/openai.yaml
  • references/backend-constraints.md
  • references/command-selection.md
  • references/ops-guidance.md
  • references/safe-editing.md
  • references/verify-workflows.md

Open the folder on GitHubat commit 9cdf9aa

Compare with similar skills

Exstruct CLI 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.

Exstruct CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Exstruct CLI this skillharumiWeb/exstruct201—~526Automated safety check: PassBSD-3-Clause
Baalda Guidenaveedharri/baalda153—~1.8kAutomated safety check: PassApache-2.0
Automate Hancom Documentsinnae1121-bit/gsghwp101—~7.9kAutomated safety check: PassMIT
Nutrient Document Processingaffaan-m/ECC274k4 repos~1.5kAutomated safety check: PassMIT
Nutrient Document Processingaffaan-m/ECC274k3 repos~1.3kAutomated safety check: PassMIT
Nutrient Document Processingaffaan-m/ECC274k2 repos~1.3kAutomated safety check: PassMIT

Similar skills

  • Baalda Guide

    naveedharri/baalda

    Answer any question about Baalda (the team second-brain app at baalda.com) in plain, non-technical language — what it is, what it can and cannot do, which file formats it supports (Markdown, images…

    153 GitHub stars~1.8k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Automate Hancom Documents

    innae1121-bit/gsghwp

    Route every Hancom/HWP document edit, analysis, and verification request to the GSGHWPBETA (gsg-hwp-beta-live) MCP.

    101 GitHub stars~7.9k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Process, convert, OCR, extract, redact, sign, and fill documents using the Nutrient DWS API.

    274k GitHub starsUsed in 4 repos~1.5k tokens
    Documents & OfficeAuto-check passed
  • 使用Nutrient DWS API处理、转换、OCR识别、提取、编辑、签名和填写文档。支持PDF、DOCX、XLSX、PPTX、HTML和图像格式。

    274k GitHub starsUsed in 3 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • Nutrient DWS API を使用してドキュメントの処理、変換、OCR、抽出、編集、署名、フォーム入力を行います。PDF、DOCX、XLSX、PPTX、HTML、画像に対応しています。

    274k GitHub starsUsed in 2 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • 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

More from harumiWeb/exstruct

All 8 skills in this repo
  • Codacy Issues Fetcher

    harumiWeb/exstruct

    Retrieve and format Codacy analysis issues by running scripts/codacyissues.py in the ExStruct workspace.

    201 GitHub stars~589 tokensUpdated 3 days ago
    Auto-check passed
  • Adr Drafter

    harumiWeb/exstruct

    Draft a new ExStruct ADR or propose an update to an existing ADR from an issue, PR, diff, tests, and specs.

    201 GitHub stars~321 tokensUpdated 3 days ago
    Auto-check passed
  • Adr Indexer

    harumiWeb/exstruct

    Maintain ExStruct ADR index artifacts by scanning ADR files and synchronizing README, index.yaml, and decision-map.md metadata.

    201 GitHub stars~349 tokensUpdated 3 days ago
    Auto-check passed
  • Adr Linter

    harumiWeb/exstruct

    Review an ExStruct ADR draft for required sections, status values, evidence quality, supersede links, and balanced consequences.

    201 GitHub stars~305 tokensUpdated 3 days ago
    Auto-check passed
  • Adr Suggester

    harumiWeb/exstruct

    Determine whether a change in ExStruct needs an ADR, using repository-specific governance and criteria.

    201 GitHub stars~354 tokensUpdated 3 days ago
    Auto-check passed
  • Adr Reviewer

    harumiWeb/exstruct

    Review an ExStruct ADR draft for decision quality, overlap with existing ADRs and specs, evidence strength, rollout risk, and human-ownership escalations.

    201 GitHub stars~610 tokensUpdated 3 days ago
    Auto-check passed

Questions about Exstruct CLI

What does Exstruct CLI do?

Use ExStruct CLI to validate, inspect, create, and edit Excel workbooks safely. Exstruct CLI is an agent skill from harumiWeb/exstruct. Use ExStruct CLI to validate, inspect, create, and edit Excel workbooks safely.

When should I use Exstruct CLI?

Exstruct CLI fits situations like: an agent needs exstruct patch; exstruct validate; exstruct ops list; exstruct ops describe.

How do I install Exstruct CLI in Claude Code?

Run `npx skills add harumiWeb/exstruct --skill exstruct-cli -a claude-code`. Or copy the skill folder (.agents/skills/exstruct-cli in harumiWeb/exstruct) into .claude/skills/exstruct-cli in your project. Claude Code loads it when a task matches its description.

How do I install Exstruct CLI in Codex?

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

Can I use Exstruct CLI 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 harumiWeb/exstruct --skill exstruct-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/exstruct-cli, .gemini/skills/exstruct-cli, .github/skills/exstruct-cli and .opencode/skills/exstruct-cli in your project.

What does Exstruct CLI need to run?

SKILL.md names no scripts, command-line tools or credentials: Exstruct CLI is instructions for the agent only.

Does Exstruct CLI access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Exstruct CLI 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 Exstruct CLI use?

Exstruct CLI is published under the BSD-3-Clause licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Exstruct CLI use?

About 526 tokens (SKILL.md is roughly 2.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.8k tokens, read only when the agent opens those files.

What are the alternatives to Exstruct CLI?

Skills that share tags, products or a category with Exstruct CLI: Baalda Guide (naveedharri/baalda, 153 stars), Automate Hancom Documents (innae1121-bit/gsghwp, 101 stars), Nutrient Document Processing (affaan-m/ECC, 274k stars) and Nutrient Document Processing (affaan-m/ECC, 274k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Exstruct CLI?

harumiWeb (a GitHub user) maintains it in harumiWeb/exstruct, which has 201 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 4, 2026.

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