# 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.

- Skill name: `import-excel`
- Category: [Documents](https://www.openparable.com/skill/documents/1)
- Source: https://github.com/zditor/zditor-docs/blob/HEAD/skills/import-excel/SKILL.md
- Repository: zditor/zditor-docs (270 GitHub stars when collected)

## SKILL.md

# Import Excel

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

## Workflow

1. Parse the Excel path plus any `--project` or `--output` options from the user request.
2. Read `references/import-excel.md` and follow its conversion rules.
3. Load the workbook with Python and `openpyxl`.
4. Validate that the sheet includes at least one data row.
5. Infer field types, options, row and col layout, cover, warm, and filenames exactly as documented.
6. 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.

---

Source: https://www.openparable.com/skill/documents/import-excel (OpenParable). Cite the canonical URL above.