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.
41 lines
1.2 KiB
Plaintext
41 lines
1.2 KiB
Plaintext
# 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 |
|