iacore
894d769051
The skill metadata had drifted: every SKILL.md name field lacked the mpi- prefix, contradicting the directory names and the Agent Skills specification. Descriptions were also missing negative triggers, making it easy for the agent to load the wrong skill. Rewrote the pdf-to-docx skill to follow progressive disclosure: the main SKILL.md dropped from 318 lines to 80, with detailed code examples moved to on-demand references. Added uv run instructions and /// script PEP 723 metadata so dependencies are declared inline and installed automatically. Fixed the pptx skill's script paths and added CLI usage messages to both pptx scripts and the normalize script. Removed the empty self-review directory that was superseded by the unified translation-review skill.
19 lines
965 B
Markdown
19 lines
965 B
Markdown
# PDF-to-DOCX Troubleshooting
|
|
|
|
| Symptom | Cause | Fix |
|
|
|---------|-------|-----|
|
|
| Text over-merged | Y-gap threshold too high | Lower gap threshold (e.g. 20 → 15) |
|
|
| Missing sections | Skipped by font filter | Add font to `skip_fonts` or remove filter |
|
|
| Over-split lines | Y-gap threshold too low | Raise gap threshold (e.g. 20 → 30) |
|
|
| Wingdings boxes | Unicode bullet inserted | Use `style='List Bullet'` instead |
|
|
| CJK font wrong | East Asian font not set | Use `set_east_asian_font()` helper |
|
|
| Image missing | Not extracted before DOCX build | Run image extraction first |
|
|
| Verse mangled | Regex too aggressive | Tune verse splitting pattern |
|
|
|
|
## General debugging steps
|
|
|
|
1. Re-inspect the PDF with the span dump from `references/inspection-guide.md`.
|
|
2. Compare the config against the actual fonts and sizes in the dump.
|
|
3. Run the verification script in `SKILL.md` and check paragraph styles.
|
|
4. Adjust one threshold at a time and re-convert.
|