
Xlsx
Lets a solo builder create, edit, and fix Excel workbooks—including formula recalculation—when an agent must deliver or repair .xlsx files without manual Excel.
Install
npx skills add https://github.com/tfriedel/claude-office-skills --skill xlsxWhat is this skill?
- Recalculates all formulas in an .xlsx via LibreOffice headless and a StarBasic RecalculateAndSave macro
- Bootstraps the LibreOffice user macro directory on macOS or Linux when missing
- Uses openpyxl to load workbooks before handing off to LibreOffice for full calculation
- Supports macOS (~/Library/Application Support/LibreOffice) and Linux (~/.config/libreoffice) macro paths
Adoption & trust: 2.2k installs on skills.sh; 725 GitHub stars; 2/3 security scanners passed (skills.sh audits); trending (+100% hot-view momentum).
Recommended Skills
Journey fit
Spreadsheet deliverables and data tables most often appear while building specs, exports, and operational reports; docs is the canonical shelf for file-based office outputs. The skill centers on producing and maintaining .xlsx artifacts (values, formulas, recalc), which maps to documentation and structured deliverables rather than app runtime code.
Common Questions / FAQ
Is Xlsx safe to install?
skills.sh reports 2 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.
SKILL.md
READMESKILL.md - Xlsx
#!/usr/bin/env python3 """ Excel Formula Recalculation Script Recalculates all formulas in an Excel file using LibreOffice """ import json import sys import subprocess import os import platform from pathlib import Path from openpyxl import load_workbook def setup_libreoffice_macro(): """Setup LibreOffice macro for recalculation if not already configured""" if platform.system() == 'Darwin': macro_dir = os.path.expanduser('~/Library/Application Support/LibreOffice/4/user/basic/Standard') else: macro_dir = os.path.expanduser('~/.config/libreoffice/4/user/basic/Standard') macro_file = os.path.join(macro_dir, 'Module1.xba') if os.path.exists(macro_file): with open(macro_file, 'r') as f: if 'RecalculateAndSave' in f.read(): return True if not os.path.exists(macro_dir): subprocess.run(['soffice', '--headless', '--terminate_after_init'], capture_output=True, timeout=10) os.makedirs(macro_dir, exist_ok=True) macro_content = '''<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE script:module PUBLIC "-//OpenOffice.org//DTD OfficeDocument 1.0//EN" "module.dtd"> <script:module xmlns:script="http://openoffice.org/2000/script" script:name="Module1" script:language="StarBasic"> Sub RecalculateAndSave() ThisComponent.calculateAll() ThisComponent.store() ThisComponent.close(True) End Sub </script:module>''' try: with open(macro_file, 'w') as f: f.write(macro_content) return True except Exception: return False def recalc(filename, timeout=30): """ Recalculate formulas in Excel file and report any errors Args: filename: Path to Excel file timeout: Maximum time to wait for recalculation (seconds) Returns: dict with error locations and counts """ if not Path(filename).exists(): return {'error': f'File {filename} does not exist'} abs_path = str(Path(filename).absolute()) if not setup_libreoffice_macro(): return {'error': 'Failed to setup LibreOffice macro'} cmd = [ 'soffice', '--headless', '--norestore', 'vnd.sun.star.script:Standard.Module1.RecalculateAndSave?language=Basic&location=application', abs_path ] # Handle timeout command differences between Linux and macOS if platform.system() != 'Windows': timeout_cmd = 'timeout' if platform.system() == 'Linux' else None if platform.system() == 'Darwin': # Check if gtimeout is available on macOS try: subprocess.run(['gtimeout', '--version'], capture_output=True, timeout=1, check=False) timeout_cmd = 'gtimeout' except (FileNotFoundError, subprocess.TimeoutExpired): pass if timeout_cmd: cmd = [timeout_cmd, str(timeout)] + cmd result = subprocess.run(cmd, capture_output=True, text=True) if result.returncode != 0 and result.returncode != 124: # 124 is timeout exit code error_msg = result.stderr or 'Unknown error during recalculation' if 'Module1' in error_msg or 'RecalculateAndSave' not in error_msg: return {'error': 'LibreOffice macro not configured properly'} else: return {'error': error_msg} # Check for Excel errors in the recalculated file - scan ALL cells try: wb = load_workbook(filename, data_only=True) excel_errors = ['#VALUE!', '#DIV/0!', '#REF!', '#NAME?', '#NULL!', '#NUM!', '#N/A'] error_details = {err: [] for err in excel_errors} total_errors = 0 for sheet_name in wb.sheetnames: ws = wb[sheet_name] # Check ALL rows and columns - no limits for row in ws.iter_rows(): for cell in row: if cell.value is not None and