xl-cli

Automate Excel operations on .xlsx files via the xl CLI.

3|Updated Nov 10, 2025
One-click install
npx skills add https://github.com/TJC-LP/xl --skill xl-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xl-cli
Source: https://github.com/TJC-LP/xl/tree/main/.claude/skills/xl-cli
Command: npx skills add https://github.com/TJC-LP/xl --skill xl-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ImageMagick, and includes references (resource) components.

What problem does it solve?

This Skill eliminates the manual drudgery of working with Excel files, allowing AI to programmatically interact with spreadsheets. It solves the challenge of integrating complex Excel operations—from data extraction and formula evaluation to advanced styling and reporting—directly into automated workflows, saving significant time and reducing errors.

Core Features & Use Cases

  • Comprehensive Excel Control: Read, write, modify, and style cells, rows, and columns with precision.
  • Advanced Data Analysis: Evaluate complex formulas, analyze cell dependencies, and perform "what-if" scenarios.
  • Flexible Output & Reporting: Export spreadsheet data to various formats like JSON, CSV, HTML, SVG, and high-quality raster images (PNG, JPEG, PDF) for diverse reporting needs.
  • Use Case: Automatically generate a weekly sales report. Extract specific data ranges from a master Excel file, apply conditional formatting to highlight key metrics, evaluate a set of financial formulas, and then export the final report as a PDF for stakeholders.

Quick Start

Using the xl-cli skill, list all sheets in the attached Excel file 'quarterly_financials.xlsx'. Then, view the range 'P&L!A1:F20' as a PNG image, including labels, and save it as 'profit_loss.png'.

Frequently Asked Questions about xl-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate reading and extracting data from Excel files via command line?

The xl-cli tool automates Excel operations through a command-line interface, letting you read cells, view ranges, and search across sheets without manual work. You specify the workbook (-f) and sheet (-s), then execute read commands to extract data programmatically into your workflow.

Can I export Excel data to JSON, CSV, PNG, and PDF formats automatically?

Yes, xl-cli supports exporting spreadsheet data to multiple formats—JSON, CSV, HTML, SVG, PNG, JPEG, and PDF—using output-oriented commands (-o). This enables flexible reporting and data integration across systems without manual file conversion.

How do I evaluate formulas and analyze cell dependencies in Excel programmatically?

xl-cli lets you evaluate complex formulas and analyze cell dependencies directly via CLI commands, enabling automated what-if scenarios and formula auditing. This integrates formula analysis into data preparation and reporting workflows without opening the spreadsheet manually.

Can I style cells and modify rows or columns across multiple sheets automatically?

Yes, xl-cli supports styling cells and modifying rows and columns across sheets through batch operations. You can apply conditional formatting and structural changes programmatically, streamlining data preparation tasks at scale.

What are the system requirements and dependencies for running xl-cli?

xl-cli requires ImageMagick as a dependency and runs as a cross-platform native binary or Java-based fallback. Ensure your environment supports one of these runtimes before executing Excel automation workflows.

Can I generate weekly or automated reports by extracting, formatting, and exporting Excel data in one workflow?

Yes, xl-cli integrates read, style, formula evaluation, and export operations into a single CLI workflow. Extract data ranges, apply conditional formatting, evaluate metrics, and export as PDF or PNG—all programmatically for recurring reporting automation.