Files
hermes-agent/skills/productivity/xlsx/scripts/xlsx_to_csv.py
T
Teknium 51570f4da7 feat: replace Anthropic office document skills with clean-room MIT implementations
The bundled docx, xlsx, powerpoint, and pdf skills were adapted from
Anthropic's document skills and carried their proprietary LICENSE.txt
(no derivatives, no redistribution). Flagged as critical license
findings by the SkillEvaluator Tier 1 scan of our skill tree.

This replaces all four with clean-room rewrites:

- Authored from scratch against library knowledge only (python-docx,
  openpyxl, python-pptx, pypdf/reportlab/pdfplumber — all MIT/BSD) by
  isolated subagents given functional specs, with an explicit
  prohibition on reading the prior skill content or anthropics/skills;
  session transcripts retained as provenance evidence.
- MIT licensed (LICENSE file per skill), author: Nous Research.
- Each skill: SKILL.md to house standards + argparse helper scripts
  with UTF-8-explicit I/O + its own e2e pytest suite (fixtures built
  on the fly, non-ASCII round-trips run under LC_ALL=C).
- All four pass SkillEvaluator Tier 1 pii+unicode+lint 3/3.

tests/skills/test_office_document_skills.py rewritten against the new
contracts: MIT/no-Anthropic-text invariants, scripts documented in
SKILL.md, argparse CLI shape, and a no-locale-default-open() check
(which caught and fixed a real gap: pdfplumber text reads are fine,
but the invariant scan now guards every future script).

Docs pages regenerated for the four skills (scoped; unrelated
generator drift excluded).

Honest capability deltas vs the old versions are documented per
SKILL.md (e.g. tracked-changes accept/reject and OOXML XSD validation
are not reimplemented; form flattening limits stated).
2026-08-08 10:46:20 -07:00

70 lines
2.3 KiB
Python

#!/usr/bin/env python3
"""Export one sheet of an .xlsx workbook to CSV.
Dates/datetimes are written in ISO format; None becomes an empty field.
With --data-only, formula cells yield their cached results (present only
if the file was last saved by Excel/LibreOffice; openpyxl never computes).
Usage:
xlsx_to_csv.py book.xlsx out.csv
xlsx_to_csv.py book.xlsx out.csv --sheet Data --encoding utf-8-sig
xlsx_to_csv.py book.xlsx out.csv --delimiter ';' --data-only
"""
from __future__ import annotations
import argparse
import csv
import json
import sys
from datetime import date, datetime, time
from openpyxl import load_workbook
def to_text(value):
if value is None:
return ""
if isinstance(value, datetime):
# Excel stores pure dates as midnight datetimes; emit a bare date.
if value.time() == time(0, 0):
return value.date().isoformat()
return value.isoformat()
if isinstance(value, (date, time)):
return value.isoformat()
return value
def main(argv=None):
ap = argparse.ArgumentParser(description=".xlsx sheet -> CSV exporter.")
ap.add_argument("file", help="input .xlsx path")
ap.add_argument("output", help="output CSV path")
ap.add_argument("--sheet", help="sheet name (default: active)")
ap.add_argument("--encoding", default="utf-8",
help="CSV output encoding (default utf-8)")
ap.add_argument("--delimiter", default=",")
ap.add_argument("--data-only", action="store_true",
help="cached formula results instead of formula strings")
args = ap.parse_args(argv)
wb = load_workbook(args.file, data_only=args.data_only)
ws = wb[args.sheet] if args.sheet else wb.active
with open(args.output, "w", newline="", encoding=args.encoding) as fh:
writer = csv.writer(fh, delimiter=args.delimiter)
count = 0
for row in ws.iter_rows(values_only=True):
writer.writerow([to_text(v) for v in row])
count += 1
print(json.dumps({"ok": True, "output": args.output, "sheet": ws.title,
"rows": count}, ensure_ascii=False))
return 0
if __name__ == "__main__":
try:
sys.exit(main())
except Exception as exc: # noqa: BLE001
print(json.dumps({"ok": False, "error": str(exc)}), file=sys.stderr)
sys.exit(1)