| name | msword-cli |
| description | Use this skill for service operations only. DO NOT use this skill for CLI implementation lifecycle work such as creating, testing, updating, troubleshooting, validating, removing, or documenting the CLI tool itself; delegate those tasks to cli-tool-expert. Execute msword operations using the `msword` CLI tool. Read Word docs, convert to markdown, and manage comments (list, add inline). Triggers: msword, msword cli, word document, docx, read word file, convert docx to markdown, word comments, extract word comments, add word comment, inline comment |
Execute msword operations using the `msword` CLI. All Word document interactions should use this CLI.
<quick_start>
The msword CLI follows this pattern:
msword docs <action> <file> [options]
| Task | Command |
|---|
| Read document text | msword docs read document.docx |
| Convert to markdown | msword docs convert document.docx |
| Convert to file | msword docs convert document.docx --output document.md |
| List comments | msword docs comments list document.docx --table |
| Filter comments by author | msword docs comments list document.docx --filter "author:Jane" |
| Add inline comment | msword docs comments add document.docx --text "Fix this" --author "Editor" --reference-text "some text" |
| </quick_start> | |
<essential_principles>
MANDATORY: Consult the adjacent usage.json at <cli-tools-root>/_repo/skills/<tool>-cli/usage.json before executing ANY msword command.
This file contains complete command syntax, all arguments, all options, and usage instructions for every command. Never guess at command syntax.
- **docs** -- Read, convert, and manage comments in Word documents (read, convert, comments {list, add})
<reference_index>
usage.json -- Complete command tree with arguments, options, defaults, and usage instructions for every command.
</reference_index>
<success_criteria>
- Command executes without error
- Output is displayed in requested format
- Correct command and flags used (verified against usage.json)
</success_criteria>
