Import Excel

Documents

import-excel

Import Excel is an Agent Skill for documents published in the zditor/zditor-docs repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use when users want to convert an Excel workbook into a Zditor SuperTag project with one markdown file per row, inferred field types, frontmatter, row and col layout, and cover metadata. Read references/import-excel.md for the conversion rules.

View on GitHub ↗

QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

Open your project in Codex.
Copy and paste the prompt below.
Review files and risks before approving any action.

Prompt to paste

Inspect the Agent Skill at https://github.com/zditor/zditor-docs/blob/HEAD/skills/import-excel/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/import-excel, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Import Excel

Use this skill when the task is to transform .xlsx or .xls data into Zditor SuperTag markdown files.

Workflow

Parse the Excel path plus any --project or --output options from the user request.
Read references/import-excel.md and follow its conversion rules.
Load the workbook with Python and openpyxl.
Validate that the sheet includes at least one data row.
Infer field types, options, row and col layout, cover, warm, and filenames exactly as documented.
Write the generated markdown files to the requested output directory.

Guardrails

Preserve original column headers in field labels.
Sanitize filenames while keeping them readable.
If openpyxl is unavailable, install it or clearly state the missing requirement.