Skip to content

feat(skill): add uv/PEP 723 support to docx-official skill#1739

Merged
yanyihan-xiaomi merged 2 commits into
mainfrom
improve-docx-skill-uv
Jul 15, 2026
Merged

feat(skill): add uv/PEP 723 support to docx-official skill#1739
yanyihan-xiaomi merged 2 commits into
mainfrom
improve-docx-skill-uv

Conversation

@yanyihan-xiaomi

@yanyihan-xiaomi yanyihan-xiaomi commented Jul 15, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Add PEP 723 inline script metadata to all Python scripts in docx-official, enabling uv run scripts/... to resolve dependencies automatically without manual install
  • Update all command examples across SKILL.md, README.md, create.md, edit.md, read.md to use uv run
  • Preserve python3 -m pip install as fallback for non-uv environments
  • Pin version constraints (lxml>=4.9, python-docx>=1.0)
  • Mention uv init as an alternative for persistent workspaces with lockfile

Follow-up (separate PRs)

  • xlsx-official: same uv treatment (has runtime/ subpackage — may need uv init approach instead)
  • pdf-official: same uv treatment (heavy deps)
  • pptx-official: clarify "self-contained" claim in docs — render_pdf.py, render_slides.py, contact_sheet.py import from local soffice_bridge.py

Add inline script metadata (PEP 723) to all Python scripts so `uv run`
resolves dependencies automatically without manual install. Update all
command examples in documentation to use `uv run scripts/...` as the
primary invocation path, preserving `python3 -m pip install` as the
fallback for environments without uv.
…nit option

Pin lxml>=4.9 and python-docx>=1.0 in inline script metadata.
Add a note about uv init as an alternative for persistent workspaces.
@yanyihan-xiaomi yanyihan-xiaomi merged commit cba1a29 into main Jul 15, 2026
9 of 10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant