transcribelisted

# /transcribe - Spreadsheet Reader The Read tool cannot open an xlsx. Use hucre, installed in this repository, as a library to read the sheets. ## Steps 1. Look at the shape of the contents. ```bash node ${CLAUDE_SKILL_DIR}/scripts/cli.js list <xlsx> ``` The sheet list and the fill ratio come out. The fill ratio is the share of cells holding a value, and it decides the next branch. 2. Decide how to read from the fill ratio. | Fill ratio | State | How to read | | ----------- | ----------------------------------------------------- | -------------------------------------------------------------- | | Under 20% | Merges and layout-only empty cells take up most of it | Convert with extract, then read | | 20% or more | Close to one record per row | Narrow to the sheet with `--sheet` and extract it on `generic` | 3. Convert. Write the output outside the repository, or wherever the user asked for. ```bash node ${CLAUDE_SKILL_DIR}/scripts/cli.js extract <xlsx> --out <dir> [--profile <name>] [--sheet <n|name>] ``` 4. Check that nothing was lost. Do not skip this check. A wrong layout judgment deletes cells without raising an error, so reconciliation is the only thing that reveals it. ```bash node ${CLAUDE_SKILL_DIR}/scripts/cli.js verify <xlsx> <dir> ``` `OK: every cell of N sheets survived into the output.` means done