fword

# 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