xhs-direct-render
Use this skill for deterministic card rendering with strong mobile readability.
Inputs
- Card markdown path
- Output directory
- Style params (font scale, heading scale, emphasis scale)
Workflow
- Run direct renderer:
python3 scripts/render_xhs_cards_direct.py --input <md> --output <dir> --width 1080 --height 1440
- Apply typography defaults:
--font-scale 1.22 --heading-scale 1.30 --emphasis-scale 1.36
- Validate:
- exactly 10 cards
- all images are
1080x1440 - no overflow/tiny-text risk in report
- Return preview paths.
- Mandatory memory update:
- append run notes to
../state/YYYY-MM-DD-<topic>.md - if defaults changed, update
../LEARNINGS.md - commit + push to
mainimmediately
- append run notes to
Design constraints
- No nested tiny screenshots.
- Key text must stay readable on phone first screen.
- Visual surprise allowed, but style must be globally consistent.