fword-skill

by jinzhengxu

Install this Skill

curl -fsSL -o fword-skill.zip https://skill.seembox.com/api/v1/skills/fword-skill/download && unzip fword-skill.zip

SKILL.md About

---
name: fword
description: "AI-powered bidirectional Word ↔ LaTeX converter. Supports multiple AI providers (Anthropic, OpenAI, Qwen, Kimi, MiniMax, DeepSeek, Zhipu). Converts Word to clean LaTeX with AI refinement, and converts back preserving original styles."
---

# Fword — Word ↔ LaTeX Converter

You are an AI assistant equipped with the Fword skill for bidirectional Word ↔ LaTeX conversion.

## When to Activate

Activate this skill when the user:
- Wants to convert a `.docx` / Word file to LaTeX
- Wants to convert a `.tex` / LaTeX file back to Word
- Asks you to edit a Word document (convert to LaTeX first, edit, convert back)
- Mentions "fword" by name

## Setup

Before first use, ensure dependencies are installed:

```bash
bash {SKILL_DIR}/scripts/setup.sh
```

Check if setup is needed by testing: `python3 -c "import pypandoc, anthropic, openai, docx"`. If this fails, run setup.

## Supported AI Providers

| Provider | Env Variable | Default Model | Flag |
|----------|-------------|---------------|------|
| Anthropic (Claude) | `ANTHROPIC_API_KEY` | `claude-sonnet-4-20250514` | `-p anthropic` |
| OpenAI | `OPENAI_API_KEY` | `gpt-4o` | `-p openai` |
| Qwen (Alibaba) | `DASHSCOPE_API_KEY` | `qwen-plus` | `-p qwen` |
| Kimi (Moonshot) | `MOONSHOT_API_KEY` | `moonshot-v1-8k` | `-p kimi` |
| MiniMax | `MINIMAX_API_KEY` | `MiniMax-Text-01` | `-p minimax` |
| DeepSeek | `DEEPSEEK_API_KEY` | `deepseek-chat` | `-p deepseek` |
| Zhipu (GLM) | `ZHIPU_API_KEY` | `glm-4-plus` | `-p zhipu` |

Any OpenAI-compatible API can also be used via `--base-url`.

## Commands

### Word → LaTeX

```bash
cd {SKILL_DIR}/scripts && python3 convert.py /absolute/path/to/document.docx /absolute/path/to/output.tex
```

Options:
- `-p, --provider PROVIDER` — AI provider (default: anthropic)
- `--model MODEL` — AI model (default: provider's default)
- `--api-key KEY` — API key (or set provider's env var)
- `--base-url URL` — Custom API base URL
- `--raw` — Pandoc-only conversion, no AI refinement (no API key needed)
- `--keep-intermediate` — Save Pandoc's raw output as `.raw.tex`

Examples:
```bash
# Default (Anthropic Claude)
cd {SKILL_DIR}/scripts && python3 convert.py /path/to/doc.docx

# Use Qwen
cd {SKILL_DIR}/scripts && python3 convert.py /path/to/doc.docx -p qwen

# Use DeepSeek with specific model
cd {SKILL_DIR}/scripts && python3 convert.py /path/to/doc.docx -p deepseek --model deepseek-chat

# Pandoc only (no AI)
cd {SKILL_DIR}/scripts && python3 convert.py /path/to/doc.docx --raw
```

### LaTeX → Word

```bash
cd {SKILL_DIR}/scripts && python3 back.py /absolute/path/to/document.tex /absolute/path/to/output.docx
```

Options:
- `--reference-doc PATH` — Use a specific Word template for styles (overrides workspace)

## Workflow

### Standard conversion

1. Run `convert.py` on the `.docx` file — this creates a `.fword/` workspace and outputs `.tex`
2. The `.fword/` workspace stores the original document as a style reference
3. Edit the LaTeX as needed
4. Run `back.py` to convert back — it automatically finds the workspace and recovers styles

### AI-assisted editing workflow

When the user wants to edit a Word document with AI help:

1. Convert: `convert.py document.docx` → produces `document.tex`
2. Read the `.tex` file and make the requested edits directly in LaTeX
3. Convert back: `back.py document.tex` → produces `document.docx` with original styles

### Quick reference

| User wants... | Action |
|---|---|
| Convert Word to LaTeX | `convert.py input.docx` |
| Convert with Qwen | `convert.py input.docx -p qwen` |
| Convert with DeepSeek | `convert.py input.docx -p deepseek` |
| Convert without AI | `convert.py input.docx --raw` |
| Convert LaTeX to Word | `back.py input.tex` |
| Edit Word doc with AI | convert → edit .tex → back |

## Important Notes

- Always use **absolute paths** for input/output files
- Always `cd {SKILL_DIR}/scripts` before running scripts (they import each other)
- Set the appropriate **environment variable** for your chosen provider's API key
- If no API key is available, use `--raw` flag for Pandoc-only conversion
- The `.fword/` workspace is created next to the output file
- For large documents, AI refinement processes in chunks automatically

_meta.json Metadata

{
  "ownerId": "kn78672nd0q76p8fn0y1qx8vz181sgvk",
  "publishedAt": 1774408454782,
  "slug": "fword-skill",
  "version": "1.1.0"
}