Files
translation-toolkit/skills
iacore bc17471635 feat(skills): make skill scripts self-executing with uv hashbang
The Python scripts in mpi-pptx-translate, mpi-pdf-to-docx-conversion, and
mpi-chinese-text-normalize previously required users to type
manually. That is easy to forget and adds friction every time the skill runs.

Switch all four scripts to a  shebang,
so they can be invoked directly: . The
 PEP 723 metadata blocks remain, so uv still installs the
dependencies automatically. Also made the scripts executable and updated
their usage messages and SKILL.md instructions to match the direct-execution
style.
2026-07-15 13:05:34 +08:00
..

# MPI Skills

These skills live in this directory and are loaded via `~/.hermes/config.yaml`.

## Install for Hermes

Add to `~/.hermes/config.yaml`:

```yaml
skills:
  external_dirs:
  - /path/to/mpi/toolkit/skills
```

{% Replace `/path/to/mpi` with the absolute path to this repository. Edit config.yaml directly — `hermes config set` stores list values as strings. %}

## Structure

Each skill follows the Agent Skills layout:

```
skill-name/
├── SKILL.md          # frontmatter + core instructions
├── scripts/          # tiny deterministic CLIs
├── references/       # docs loaded on demand
└── assets/           # templates and static files
```

The `name` field in each `SKILL.md` frontmatter matches the directory name.

## Skills

| Name | What it does |
|---|---|
| `mpi-translation` | Translate Chinese↔English Buddhist/Dharma content |
| `mpi-terms-search` | Full-text search across MPI term database |
| `mpi-translation-review` | Review translations for quality issues |
| `mpi-chinese-text-normalize` | Normalize Chinese markdown line breaks |
| `mpi-pptx-translate` | Translate PowerPoint files |
| `mpi-pdf-to-docx-conversion` | Convert PDFs to DOCX with layout preservation |