refactor(skills): align MPI skills with Agent Skills best practices

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.
This commit is contained in:
iacore
2026-07-14 23:18:55 +08:00
parent 216a7658ac
commit 894d769051
16 changed files with 371 additions and 361 deletions
+4 -8
View File
@@ -1,13 +1,9 @@
---
name: translation-review
name: mpi-translation-review
description: |
Unified review skill for Chinese-English Buddhist/Dharma translations.
Supports two modes:
- **self**: You translated the text. Edit target.dj directly.
- **other**: Someone else translated. Write review-comments.dj, do not edit target.dj.
What to review is identical in both modes — the same detection rules,
editorial standards, and terminology checks. Only the action differs: self
mode applies fixes directly; other mode records them for the translator.
Unified review skill for Chinese-English Buddhist/Dharma translations in djot format.
Use in self mode to edit your own target.dj, or in other mode to write review-comments.dj for a peer translator.
Do not use for non-djot formats or for non-Buddhist texts.
---
# Translation Review (unified)
@@ -17,9 +17,12 @@ correspondence, generate `bilingual.dj` directly from the DOCX:
4. Write bilingual.dj
The DOCX English is the authoritative target text. No PDF needed.
**Extraction approach**: start by adapting `toolkit/scripts/gen-bilingual-docx.py`.
For articles where the body has strict CN→EN→CN→EN alternation, the simple
extraction in that script (CN line, blank, EN line, blank) works directly.
**Extraction approach**: write a custom extraction script. The standard
`toolkit/scripts/gen-bilingual.py` expects separate `source.dj` and `target.dj` files;
for DOCX→bilingual extraction, adapt its pattern-matching logic to read from the
pandoc plain-text output instead. For articles where the body has strict
CN→EN→CN→EN alternation, the simple extraction (CN line, blank, EN line, blank)
works directly.
### A2. Bilingual from `.docx.md` (pandoc markdown output)